getservbyname
getservbyname 함수는 서비스 이름과 프로토콜에 부합하는 서비스 정보를 얻어냅니다.
struct SERVENT FAR * getservbyname (
const
char FAR * name,
const char FAR
* proto
);
Parameters
name
[입력] NULL문자로 끝나는 서비스
이름 스트링의 포인터 (서비스의 공식적인 이름이나 공인된 앨리어스입니다.)
proto
[입력] 임의의 프로토콜 이름입니다.
proto가 NULL일 경우 getservbyname
함수는 서비스 이름과 일치하는 서비스 데이터 베이스의 첫번째 엔트리를 반환합니다.
proto가 NULL이 아닐경우 getservbyname
함수는 서비스 이름과 프로토콜 이름에 일치하는 엔트리를 찾으려고 시도합니다.
Remarks
getservbyname 함수는 name 매개변수 스트링과 일치하는 SERVENT 구조체를 리턴합니다. 모든 스트링은 NULL 문자로 끝나는 스트링입니다.
SERVENT 구조체의 포인터는 윈도우즈 소켓 시스템에 할당됩니다. 애플리케이션에서는 이 구조체를 수정하거나 내용을 비워서는 않됩니다. 또한 각각의 쓰레드에 대하여 이구조체의 한개의 카피본 만이 할당되어야 합니다. 유효성은 다른 윈도우즈 소켓 함수가 호출될 때 까지만 보장되므로 애플리케이션은 이 정보가 필요하다면, 다른 윈도우즈 소켓 함수가 호출되기 전에 특정한 정보를 카피해야 합니다.
Return Values
에러가 발생하지 않으면, getservbyname 함수는 SERVENT 구조체의 포인터를 리턴합니다. 에러가 발생하면, 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