getprotobynumber
getprotobynumber 함수는 매개변수의 프로토콜 번호와 부합되는 프로토콜 정보를 얻어내는 함수 입니다.
struct PROTOENT FAR * getprotobynumber (
int
number
);
Parameters
number
[입력]
호스트 바이트 오더(리틀-인디언) 형태의 프로토콜 번호
Remarks
getprotobynumber 함수는 number 매개변수로 넣은 프로토콜 번호와 대응되는 프로토콜 번호와 이름을 포함한 PROTOENT 구조체를 반환합니다.
PROTOENT 구조체는 윈도우즈 소켓 시스템에 할당됩니다. 애플리케이션에서는 이 구조체를 수정하거나 내용을 비워서는 않됩니다. 또한 각각의 쓰레드에 대하여 이구조체의 한개의 카피본 만이 할당되어야 합니다. 유효성은 다른 윈도우즈 소켓 함수가 호출될 때 까지만 보장되므로 애플리케이션은 이 정보가 필요하다면, 다른 윈도우즈 소켓 함수가 호출되기 전에 특정한 정보를 카피해야 합니다.
Return Values
에러가 발생하지 않으면, getprotobynumber 함수는 PROTOENT 구조체의 포인터를 리턴합니다. 에러가 발생하면, NULL 포인터를 리턴하게 됩니다. 그리고, WSAGetLastError 함수를 호출해서 특정한 에러코드를 얻어낼 수 있습니다.
Error Codes
|
WSANOTINITIALISED |
이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
|
WSAENETDOWN |
네트웍 서브 시스템에 에러가 발생했습니다. |
|
WSAHOST_NOT_FOUND |
올바른 호스트 응답을 찾을 수 없습니다. |
|
WSATRY_AGAIN |
올바른 호스트가 발견되지 않거나 서버에서 에러가 났습니다. |
|
WSANO_RECOVERY |
회복할 수 없는 에러발생으로 프로토콜 데이터 베이스를 엑세스 할 수 없습니다. |
|
WSANO_DATA |
요청된 형태의 데이터 레코드가 없습니다. |
|
WSAEINPROGRESS |
블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
|
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