getprotobyname
getprotobyname 함수는 프로토콜 이름에 대응되는 프로토콜 정보를 얻어내는 함수입니다.
struct PROTOENT FAR * getprotobyname (
const
char FAR * name
);
Parameters
name
[입력] NULL로 끝나는 프로토콜
이름 스트링의 포인터
Remarks
getprotobyname 함수는 name 매개변수로 넣은 프로토콜과 대응되는 프로토콜 번호와 이름을 포함한 PROTOENT 구조체를 반환합니다. 모든 스트링은 NULL로 끝나는 문자열입니다. PROTOENT 구조체는 윈도우즈 소켓 시스템에 할당됩니다. 애플리케이션에서는 이 구조체를 수정하거나 내용을 비워서는 않됩니다. 또한 각각의 쓰레드에 대하여 이구조체의 한개의 카피본 만이 할당되어야 합니다. 유효성은 다른 윈도우즈 소켓 함수가 호출될 때 까지만 보장되므로 애플리케이션은 이 정보가 필요하다면, 다른 윈도우즈 소켓 함수가 호출되기 전에 특정한 정보를 카피해야 합니다.
Return Values
에러가 없는 경우에 getprotobyname 함수는 PROTOENT 구조체의 포인터를 리턴합니다. 에러가 발생한 경우에는 NULL 포인터를 반환하게 되죠. 그리고 WSAGetLastError 함수를 호출해서 특정한 에러코드를 얻어낼 수 있습니다.
Error Codes
|
WSANOTINITIALISED |
이 함수를 사용하기 전에 성공적인 WSAStartup 함수를 호출이 없었습니다. |
|
WSAENETDOWN |
네트웍 서브 시스템에 에러가 발생했습니다. |
|
WSAHOST_NOT_FOUND |
올바른 호스트 응답을 찾을 수 없습니다. |
|
WSATRY_AGAIN |
올바른 호스트가 발견되지 않거나 서버에서 에러가 났습니다. |
|
WSANO_RECOVERY |
회복할 수 없는 에러발생으로 프로토콜 데이터 베이스를 엑세스 할 수 없습니다. |
|
WSANO_DATA |
요청된 형태의 데이터 레코드가 없습니다. |
|
WSAEINPROGRESS |
블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
|
WSAEFAULT |
name 매개변수가 user address space의 올바를 형태가 아닙니다. |
|
WSAEINTR |
블럭킹 윈속 v1.1 이 WSACancelBlockingCall 함수에서 취소되었습니다. |
QuickInfo
Windows NT : 사용가능
Windows :
사용가능
Windows CE : 버젼 1.0 그리고 그이후의 버젼에서 사용가능
Header
:
Win16/32
: winsock.h
Win32-II
: winsock2.h
Import Library :
Win16 : winsock.lib
Win32
: wsock32.lib
Win32-II
: ws2_32.lib