gethostbyname 関数 (winsock.h)

gethostbyname 関数は、ホスト データベースからホスト名に対応するホスト情報を取得します。

構文

hostent * gethostbyname(
  const char *name
);

パラメーター

name

TBD

戻り値

エラーが発生しない場合、 gethostbyname は上記の ホスト型 構造体へのポインターを返します。 それ以外の場合は null ポインターを返し、 WSAGetLastError を呼び出すことで特定のエラー番号を取得できます。

注釈

gethostbyname 関数は、ホスト型構造体 (Windows ソケットによって割り当てられた構造体) へのポインターを返します。 hostent 構造体には、name パラメーターで指定されたホストが正常に検索された結果が含まれます。

name パラメーターで指定されたホストに IPv4 アドレスと IPv6 アドレスの両方がある場合は、IPv4 アドレスのみが返されます。 gethostbyname 関数は、name パラメーターの IPv4 アドレスのみを返すことができます。 ホストの IPv6 アドレスが必要な場合、またはホストの IPv4 アドレスと IPv6 アドレスの両方が必要な場合は、 getaddrinfo 関数と関連する addrinfo 構造体を使用する必要があります。

name パラメーターが空の文字列を指している場合、または name が NULL の場合、返される文字列は、成功した gethostname 関数呼び出し (ローカル コンピューターの標準ホスト名) によって返される文字列と同じです。

name パラメーターに有効な IPv4 アドレスの文字列表現が含まれている場合は、文字列を表すバイナリ IPv4 アドレスがホスト型構造体で返されます。 ホスト型構造体の h_name メンバーには、IPv4 アドレスの文字列表現が含まれており、h_addr_listにはバイナリ IPv4 アドレスが含まれています。 name パラメーターに IPv6 アドレスまたは無効な IPv4 アドレスの文字列表現が含まれている場合、gethostbyname 関数は失敗し、WSANO_DATAを返します。

gethostbyname 関数によって返されるホスト型構造体のメモリは、スレッド ローカル ストレージから Winsock DLL によって内部的に割り当てられます。 スレッドで gethostbyaddr 関数または gethostbyname 関数が何回呼び出されても、1 つのホスト型構造体のみが割り当てられ、使用されます。 同じスレッドの gethostbyname 関数または gethostbyaddr 関数に対して追加の呼び出しを行う場合は、返されたホスト型構造体をアプリケーション バッファーにコピーする必要があります。 それ以外の場合、戻り値は、同じスレッドで後続の gethostbyname または gethostbyaddr 呼び出しによって上書きされます。 返された ホスト型 構造体に割り当てられた内部メモリは、スレッドの終了時に Winsock DLL によって解放されます。

アプリケーションは、返された ホスト 型構造体によって使用されるメモリを解放しようとしないでください。 アプリケーションは、この構造を変更したり、そのコンポーネントを解放したりしないでください。 さらに、この構造体のコピーはスレッドごとに 1 つだけ割り当てられるため、アプリケーションは 、gethostbyname または gethostbyaddr への他の関数呼び出しを発行する前に、必要な情報をコピーする必要があります。

gethostbyname 関数は、名前に渡されたパラメーターとして IP アドレス文字列を受け取り、ホスト名に解決することはできません。 このような要求は、IPv4 アドレスの文字列表現または不明なホスト名が渡されたと正確に扱われます。 アプリケーションでは 、inet_addr を使用して IPv4 アドレス文字列をバイナリ IPv4 アドレスに変換し、別の関数 gethostbyaddr を使用して IPv4 アドレスをホスト名に解決できます。

コード例

#include <winsock2.h>
#include <ws2tcpip.h>
#include <stdio.h>
#include <windows.h>
#pragma comment(lib, "ws2_32.lib")

int main(int argc, char **argv)
{

    //-----------------------------------------
    // Declare and initialize variables
    WSADATA wsaData;
    int iResult;

    DWORD dwError;
    int i = 0;

    struct hostent *remoteHost;
    char *host_name;
    struct in_addr addr;

    char **pAlias;

    // Validate the parameters
    if (argc != 2) {
        printf("usage: %s hostname\n", argv[0]);
        printf("  to return the IP addresses for the host\n");
        printf("       %s www.contoso.com\n", argv[0]);
        printf(" or\n");
        printf("       %s IPv4string\n", argv[0]);
        printf("  to return an IPv4 binary address for an IPv4string\n");
        printf("       %s 127.0.0.1\n", argv[0]);
        return 1;
    }
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != 0) {
        printf("WSAStartup failed: %d\n", iResult);
        return 1;
    }

    host_name = argv[1];

    printf("Calling gethostbyname with %s\n", host_name);
    remoteHost = gethostbyname(host_name);
    
    if (remoteHost == NULL) {
        dwError = WSAGetLastError();
        if (dwError != 0) {
            if (dwError == WSAHOST_NOT_FOUND) {
                printf("Host not found\n");
                return 1;
            } else if (dwError == WSANO_DATA) {
                printf("No data record found\n");
                return 1;
            } else {
                printf("Function failed with error: %ld\n", dwError);
                return 1;
            }
        }
    } else {
        printf("Function returned:\n");
        printf("\tOfficial name: %s\n", remoteHost->h_name);
        for (pAlias = remoteHost->h_aliases; *pAlias != 0; pAlias++) {
            printf("\tAlternate name #%d: %s\n", ++i, *pAlias);
        }
        printf("\tAddress type: ");
        switch (remoteHost->h_addrtype) {
        case AF_INET:
            printf("AF_INET\n");
            break;
        case AF_NETBIOS:
            printf("AF_NETBIOS\n");
            break;
        default:
            printf(" %d\n", remoteHost->h_addrtype);
            break;
        }
        printf("\tAddress length: %d\n", remoteHost->h_length);

        i = 0;
        if (remoteHost->h_addrtype == AF_INET)
        {
            while (remoteHost->h_addr_list[i] != 0) {
                addr.s_addr = *(u_long *) remoteHost->h_addr_list[i++];
                printf("\tIP Address #%d: %s\n", i, inet_ntoa(addr));
            }
        }
        else if (remoteHost->h_addrtype == AF_NETBIOS)
        {   
            printf("NETBIOS address was returned\n");
        }   
    }

    return 0;
}

Windows Phone 8: この関数は、Windows Phone 8 以降のWindows Phone ストア アプリでサポートされています。

Windows 8.1とWindows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。

要件

こちらもご覧ください

GetAddrInfoEx

GetAddrInfoW

WSAAsyncGetHostByName

Winsock 関数

Winsock リファレンス

addrinfo

addrinfoW

getaddrinfo

gethostbyaddr

gethostname

hostent

inet_addr