gethostbyname

gethostbyname

gethostbyname 함수는 호스트 데이터베이스로 부터 호스트 이름에 대응되는 호스트 정보를 얻어내는 함수이다.

struct HOSTENT FAR * gethostbyname (
const char FAR * name
);

Parameters

name
[입력] NULL로 끝나는 호스트 이름

Remarks

gethostbyaddr 함수와 같이 gethostbyname 함수는 리턴값으로 HOSTENT 구조체에 대한 포인터나 NULL을 반환 합니다. 구조체는 윈도우즈 소켓 시스템에 할당됩니다. 애플리케이션에서는 이 구조체를 수정하거나 내용을 비워서는 않됩니다. 또한 각각의 쓰레드에 대하여 이구조체의 한개의 카피본 만이 할당되어야 합니다. 유효성은 다른 윈도우즈 소켓 함수가 호출될 때 까지만 보장되므로 애플리케이션은 이 정보가 필요하다면, 다른 윈도우즈 소켓 함수가 호출되기 전에 특정한 정보를 카피해야 합니다.

Return Values

아무런 에러가 발생하지 않는다면, gethostbyname 함수는 HOSTENT 구조체의 포인터를 리턴할 겁니다. 에러가 발생한 경우에는 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

아래의 사용예제는 로컬 호스트의 IP Address를 쩜~표기법으로 이루어지는 스트링으로 얻어내는 방법을 보여주는 예제입니다. 버클리 소켓의 경우 로컬 호스트의 아이피 어드레스를 얻어내는 gethostaddr 함수는 지원되는 API이지만, Winsock에서는 지원되지 않는 API입니다. 하지만, 아래처럼 단지 몇줄만의 코딩으로 이와 똑같은 기능을 하는 함수를 만들어 낼 수 있음을 알 수 있습니다.

char FAR * FAR gethostaddr( void )
{
        char szHostName[40];

        //로컬 호스트의 이름을 얻습니다.
        int nResult = gethostname( szHostName, sizeof(szHostName) );
        if( nResult != 0)
                return NULL;

        //호스트 이름이 유효한지 확인 합니다.
        if( lstrcmp( szHostName, "" ) == 0 )
                return NULL;

        //로컬 호스트 이름을 이용하여 호스트 관련 정보를 찾습니다.
        HOSTENT FAR * lphostent = gethostbyname( szHostName );

        //호스트 정보를 제대로 얻었는지 확인하고,
        if( lphostent == NULL )
                return NULL;

        //제대로 호스트 관련 정보를 얻었으면, 관련정보중 아이피 스트링을 반환 합니다.
        return lphostent->h_addr_list;
}

See Also