gethostname

gethostname

gethostname 함수는 로컬 머신에 대한 호스트 이름을 얻어냅니다.

int gethostname (
char FAR * name,
int namelen
);

Parameters

name
[출력] 로컬 호스트 이름을 담을 버퍼의 포인터

namelen
[입력] 버퍼의 길이를 설정합니다.

Remarks

gethostname 함수는 name 매개변수에 로컬 호스트의 이름을 리턴합니다. 호스트 이름은 NULL 문자로 끝나는 스트링 입니다. 호스트 이름의 형태는 윈도우즈 소켓 프로바이더에 종속적입니다. 즉, 간단한 호스트 이름일 수도 있고, 완벽한 도메인 네임 일 수도 있는 것입니다.

만약 로컬 호스트 이름이 존재하고 있었다면, gethostname 함수는 성공할 것입니다, 그리고 gethostbyname 함수나 WSAAsyncGetHostByName 함수에서 인식 할 수 있는 호스트 이름을 리턴하게 됩니다.

Return Values

아무런 에러가 발생되지 않으면, gethostname 함수는 0을 리턴합니다. 반면, 에러가 발생한 경우에는 SOCKET_ERROR 을 리턴합니다. 또한 이 함수역시 WSAGetLastError 함수를 호출해서 특정한 에러코드를 받아낼 수 있습니다.

Error Codes

WSAEFAULT	name 매개변수가 정확한 user address space가 아니거나, namelen에 넘긴 버퍼크기가 호스트 이름을 모두 담을 만큼의 크기가 아닐경우
WSANOTINITIALISED	이 함수를 사용하기전에 성공적인 WSAStartup 함수의 호출이 이루어져야 합니다.
WSAENETDOWN	네트웍 서브 시스템에서 에러가 났습니다.
WSAEINPROGRESS	블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다.

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