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