HOSTENT

hostent 構造体は、ホスト名や IPv4 アドレスなど、指定されたホストに関する情報を格納するために関数によって使用されます。アプリケーションは、この構造体を変更したり、その構成要素を解放したりしようとしてはなりません。さらに、 hostent 構造体はスレッドごとに 1 つのコピーしか割り当てられないため、アプリケーションは他の Windows Sockets API を呼び出す前に、必要な情報をコピーしておく必要があります。

gethostbyaddr 関数および gethostbyname 関数は、 hostent 構造体 (Windows Sockets によって割り当てられる構造体) へのポインターを返します。 hostent 構造体には、name パラメーターで指定されたホストの検索に成功した結果が格納されます。

gethostbyaddr 関数および gethostbyname 関数が返す hostent 構造体のメモリーは、Winsock DLL によってスレッドローカルストレージから内部的に割り当てられます。同じスレッドで gethostbyaddr 関数や gethostbyname 関数を何回呼び出しても、割り当てられて使用される hostent 構造体は 1 つだけです。同じスレッドで gethostbyaddr 関数や gethostbyname 関数をさらに呼び出す場合は、返された hostent 構造体をアプリケーションのバッファーにコピーしなければなりません。コピーしないと、戻り値は同じスレッドでの後続の gethostbyaddr 呼び出しや gethostbyname 呼び出しによって上書きされます。返された hostent 構造体のために内部的に割り当てられたメモリーは、スレッドの終了時に Winsock DLL によって解放されます。

アプリケーションは、返された hostent 構造体が使用しているメモリーを解放しようとしてはなりません。アプリケーションは、この構造体を変更したり、その構成要素を解放したりしようとしてはなりません。さらに、この構造体はスレッドごとに 1 つのコピーしか割り当てられないため、アプリケーションは gethostbyaddr や gethostbyname を他に呼び出す前に、必要な情報をコピーしておく必要があります。

例

次の例は、gethostbyname 関数と共に hostent 構造体を使用する方法を示しています。

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <ws2tcpip.h>
#include <stdio.h>

// Need to link with Ws2_32.lib
#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 ipv4address\n", argv[0]);
        printf(" or\n");
        printf("       %s hostname\n", argv[0]);
        printf("  to return the host\n");
        printf("       %s 127.0.0.1\n", argv[0]);
        printf("  to return the IP addresses for a host\n");
        printf("       %s www.contoso.com\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];

// If the user input is an alpha name for the host, use gethostbyname()
// If not, get host by addr (assume IPv4)
    if (isalpha(host_name[0])) {        /* host address is a name */
        printf("Calling gethostbyname with %s\n", host_name);
        remoteHost = gethostbyname(host_name);
    } else {
        printf("Calling gethostbyaddr with %s\n", host_name);
        addr.s_addr = inet_addr(host_name);
        if (addr.s_addr == INADDR_NONE) {
            printf("The IPv4 address entered must be a legal address\n");
            return 1;
        } else
            remoteHost = gethostbyaddr((char *) &addr, 4, AF_INET);
    }

    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_INET6:
            printf("AF_INET6\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);

        if (remoteHost->h_addrtype == AF_INET) {
            while (remoteHost->h_addr_list[i] != 0) {
                addr.s_addr = *(u_long *) remoteHost->h_addr_list[i++];
                printf("\tIPv4 Address #%d: %s\n", i, inet_ntoa(addr));
            }
        } else if (remoteHost->h_addrtype == AF_INET6)
            printf("\tRemotehost is an IPv6 address\n");
    }

    return 0;
}