gethostbyaddr
gethostbyaddr 함수는 네트웍 어드레스에 대응되는 호스트 정보를 반환하는 함수입니다.
struct HOSTENT FAR * gethostbyaddr (
const
char FAR * addr,
int len,
int
type
);
Parameters
addr
[입력] 네트웍 바이트 오더의 어드레스
포인터 (주의:쩜 표기법의 스트링이 아닙니다.)
len
[입력] 어드레스의 길이를 지정 지정합니다.
( 32비트 IP 어드레스의 경우 항상 4 )
type
[입력] 어드레스의 형태 ( ex :
PF_INET )
Remarks
gethostbyaddr 함수는 주어진 네트웍 어드레스와 대응되는 이름과 주소를 가진 HOSTENT 구조체의 포인터를 리턴합니다. 모든 스트링은 NULL로 끝나는 문자 입니다.
Return Values
아무런 에러가 발생되지 않았으면, HOSTENT 구조체의 포인터를 리턴합니다. 에러가 발생한경우에는 NULL 포인터를 리턴합니다. 그외 특별한 에러코드를 얻고자 할때는 WSAGetLastError 함수를 호출하여 에러사항을 검출해 낼 수 있습니다.
Error Codes
|
WSANOTINITIALISED |
이 함수를 사용하기 이전에 WSAStartup 함수를 성공적으로 호출해야 합니다. |
|
WSAENETDOWN |
네트웍 서브 시스템에서 에러가 났습니다. |
|
WSAHOST_NOT_FOUND |
올바른 호스트 응답을 발견 할 수 없습니다. |
|
WSATRY_AGAIN |
올바른 호스트가 발견되지 않거나 서버에서 에러가 났습니다. |
|
WSANO_RECOVERY |
회복할 수 없는 에러가 발생했습니다. |
|
WSANO_DATA |
요청한 형태의 데이터가 기록되지 않았습니다. |
|
WSAEINPROGRESS |
블럭킹 윈속 v1.1이 진행상태에 있거나, 서비스 프로바이더가 아직 콜백함수를 진행하고 있습니다. |
|
WSAEAFNOSUPPORT |
매개변수의 type이 윈속에서 지원되지 않는 형태입니다. |
|
WSAEFAULT |
addr 매개변수가 사용자 주소 공간에서 올바를 형태가 아니거나, len 매개변수가 너무 작습니다. |
|
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