ADDRINFOEX4構造体 (ws2def.h)

  • [アーティクル]

addrinfoex4 構造体は、特定のネットワーク インターフェイスが要求されたときにホスト アドレス情報を保持するために GetAddrInfoEx 関数によって使用されます。

構文

typedef struct addrinfoex4 {
  int                ai_flags;
  int                ai_family;
  int                ai_socktype;
  int                ai_protocol;
  size_t             ai_addrlen;
  PWSTR              ai_canonname;
  struct sockaddr    *ai_addr;
  void               *ai_blob;
  size_t             ai_bloblen;
  GUID               *ai_provider;
  struct addrinfoex4 *ai_next;
  int                ai_version;
  PWSTR              ai_fqdn;
  int                ai_interfaceindex;
  HANDLE             ai_resolutionhandle;
} ADDRINFOEX4, *PADDRINFOEX4, *LPADDRINFOEX4;

メンバー

ai_flags

GetAddrInfoEx 関数で使用されるオプションを示すフラグ。

ai_flags メンバーでサポートされる値は Winsock2.h インクルード ファイルで定義され、次のオプションの組み合わせにすることができます。

値 意味
AI_PASSIVE
0x01
 ソケット アドレスは、 バインド 関数の呼び出しで使用されます。
AI_CANONNAME
0x02
 正規名は、最初の ai_canonname メンバーで返されます。
AI_NUMERICHOST
0x04
 GetAddrInfoEx 関数に渡される nodename パラメーターは、数値文字列である必要があります。
AI_ALL
0x0100
 このビットが設定されている場合、AI_V4MAPPEDを 持つ IPv6 アドレスと IPv4 アドレスに対して要求が行われます。

このオプションは、Windows Vista 以降でサポートされています。
AI_ADDRCONFIG
0x0400
 GetAddrInfoEx は、グローバル アドレスが構成されている場合にのみ解決されます。 IPv6 および IPv4 ループバック アドレスは、有効なグローバル アドレスとは見なされません。

このオプションは、Windows Vista 以降でサポートされています。
AI_V4MAPPED
0x0800
 IPv6 アドレスに対 する GetAddrInfoEx 要求が失敗した場合、IPv4 アドレスに対してネーム サービス要求が行われ、これらのアドレスは IPv4 マップされた IPv6 アドレス形式に変換されます。

このオプションは、Windows Vista 以降でサポートされています。
AI_NON_AUTHORITATIVE
0x04000
 アドレス情報は、権限のない結果から取得されます。

GetAddrInfoEx の pHints パラメーターでこのオプションを設定すると、NS_EMAIL名前空間プロバイダーは権限のある結果と権限のない結果の両方を返します。 このオプションが設定されていない場合は、権限のある結果のみが返されます。

このオプションは、Windows Vista 以降の NS_EMAIL 名前空間でのみサポートされます。
AI_SECURE
0x08000
 アドレス情報は、セキュリティで保護されたチャネルからの情報です。

AI_SECURE ビットが設定されている場合、NS_EMAIL名前空間プロバイダーは、スプーフィングの可能性を最小限に抑えるために、強化されたセキュリティで取得された結果を返します。

GetAddrInfoEx の pHints パラメーターでこのオプションを設定すると、NS_EMAIL名前空間プロバイダーは、スプーフィングの可能性を最小限に抑えるために、強化されたセキュリティで取得された結果のみを返します。

このオプションは、Windows Vista 以降の NS_EMAIL 名前空間でのみサポートされます。
AI_RETURN_PREFERRED_NAMES
0x010000
 アドレス情報は、特定の名前空間を持つパブリケーションに推奨される名前用です。

GetAddrInfoEx の pHints パラメーターでこのオプションを設定すると、pName パラメーターに名前を指定する必要はなく、NS_EMAIL名前空間プロバイダーはパブリケーションの優先名を返します。

このオプションは、Windows Vista 以降の NS_EMAIL 名前空間でのみサポートされます。
AI_FQDN
0x00020000
 完全修飾ドメイン名は、最初の ai_fqdn メンバーで返されます。

GetAddrInfoEx の pHints パラメーターでこのオプションを設定し、pName パラメーターにフラット名 (単一ラベル) を指定すると、最終的に名前が解決された完全修飾ドメイン名が返されます。

このオプションは、Windows 7、Windows Server 2008 R2 以降でサポートされています。
AI_FILESERVER
0x00040000
 クエリ対象のホスト名がファイル共有シナリオで使用されていることを示す名前空間プロバイダーへのヒント。 名前空間プロバイダーは、このヒントを無視できます。

このオプションは、Windows 7、Windows Server 2008 R2 以降でサポートされています。
AI_DISABLE_IDN_ENCODING
0x00080000
 GetAddrInfoEx 関数によって呼び出される名前解決関数で Punycode を使用して、国際ドメイン名の自動エンコードを無効にします。

このオプションは、Windows 8、Windows Server 2012、以降でサポートされています。
AI_EXTENDED
0x80000000
 現在のオブジェクトが拡張されていることを示します。つまり、 addrinfoex2 以上です。

このオプションは、Windows 8.1、Windows Server 2012 R2 以降でサポートされています。
AI_RESOLUTION_HANDLE
0x40000000
 解決ハンドルは、 ai_resolutionhandle メンバーで返されます。

このオプションは、Windows 10、Windows Server 2016、以降でサポートされています。

ai_family

アドレス ファミリ。

アドレス ファミリに使用できる値は、 Ws2def.h ヘッダー ファイルで定義されています。 Ws2def.h ヘッダー ファイルは Winsock2.h に自動的に含まれるので、直接使用しないでください。

現在サポートされている値は 、IPv4 と IPv6 のインターネット アドレス ファミリ形式である AF_INETまたはAF_INET6です。 アドレス ファミリの Windows ソケット サービス プロバイダーがインストールされている場合、アドレス ファミリのその他のオプション (NetBIOS で使用するためのAF_NETBIOSなど) がサポートされます。 AF_ アドレス ファミリ定数とPF_ プロトコル ファミリ定数の値は同一であるため ( たとえば、AF_INET と PF_INET)、どちらの定数も使用できます。

次の表に、アドレス ファミリの一般的な値を示しますが、他の多くの値を使用できます。

値 意味
AF_UNSPEC
0
 アドレス ファミリが指定されていません。
AF_INET
2
 インターネット プロトコル バージョン 4 (IPv4) アドレス ファミリ。
AF_NETBIOS
17
 NetBIOS アドレス ファミリ。 このアドレス ファミリは、NetBIOS 用 Windows ソケット プロバイダーがインストールされている場合にのみサポートされます。
AF_INET6
23
 インターネット プロトコル バージョン 6 (IPv6) アドレス ファミリ。
AF_IRDA
26
 赤外線データ関連付け (IrDA) アドレス ファミリ。 このアドレス ファミリは、コンピューターに赤外線ポートとドライバーがインストールされている場合にのみサポートされます。
AF_BTH
32
 Bluetooth アドレス ファミリ。 このアドレス ファミリは、Bluetooth アダプターがインストールされている場合にのみサポートされます。

ai_socktype

ソケットの種類。 ソケットの種類に使用できる値は、 Winsock2.h インクルード ファイルで定義されています。

次の表に、Windows ソケット 2 でサポートされているソケットの種類に使用できる値を示します。

値 意味
Sock_stream
1
 OOB データ転送メカニズムを使用して、シーケンス化された信頼性の高い双方向の接続ベースのバイト ストリームを提供します。 インターネット アドレス ファミリ (AF_INET または AF_INET6) に伝送制御プロトコル (TCP) を使用します。 ai_family メンバーがAF_IRDA場合、サポートされているソケットの種類は SOCK_STREAM のみです。
SOCK_DGRAM
2
 固定 (通常は小さい) 最大長のコネクションレスで信頼性の低いバッファーであるデータグラムをサポートします。 インターネット アドレス ファミリ (AF_INET または AF_INET6) にユーザー データグラム プロトコル (UDP) を使用します。
SOCK_RAW
3
 アプリケーションが次の上位層プロトコル ヘッダーを操作できるようにする生ソケットを提供します。 IPv4 ヘッダーを操作するには、 ソケットで IP_HDRINCL ソケット オプションを設定する必要があります。 IPv6 ヘッダーを操作するには、 ソケットに IPV6_HDRINCL ソケット オプションを設定する必要があります。
SOCK_RDM
4
 信頼性の高いメッセージ データグラムを提供します。 この種類の例として、Windows でのプラグマティック一般マルチキャスト (PGM) マルチキャスト プロトコルの実装があります。これは、 信頼性の高いマルチキャスト プログラミングと呼ばれることがよくあります。
SOCK_SEQPACKET
5
 データグラムに基づいて擬似ストリーム パケットを提供します。
 

Windows ソケット 2 では、新しいソケットの種類が導入されました。 アプリケーションは、 WSAEnumProtocols 関数を使用して、使用可能な各トランスポート プロトコルの属性を動的に検出できます。 そのため、アプリケーションはアドレス ファミリで使用できるソケットの種類とプロトコルのオプションを決定し、このパラメーターを指定するときにこの情報を使用できます。 Winsock2.h ヘッダー ファイルと Ws2def.h ヘッダー ファイルのソケットの種類の定義は、新しいソケットの種類、アドレス ファミリ、およびプロトコルが定義されると定期的に更新されます。

Windows ソケット 1.1 では、使用可能なソケットの種類は SOCK_DATAGRAM と SOCK_STREAMのみです。

ai_protocol

プロトコルの種類。 使用可能なオプションは、指定されたアドレス ファミリとソケットの種類に固有です。 ai_protocolに使用できる値は、Winsock2.h ヘッダー ファイルと Wsrm.h ヘッダー ファイルで定義されています。

Windows Vista 以降でリリースされたWindows SDKでは、ヘッダー ファイルのorganizationが変更され、このメンバーは Ws2def.h ヘッダー ファイルで定義されている IPPROTO 列挙型の値のいずれかになります。 Ws2def.h ヘッダー ファイルは Winsock2.h に自動的に含まれるので、直接使用しないでください。

ai_protocolに値 0 を指定した場合、呼び出し元はプロトコルを指定せず、サービス プロバイダーは使用するai_protocolを選択します。 IPv4 および IPv6 以外のプロトコルの場合は、 ai_protocol を 0 に設定します。

次の表は、他の多くの値が可能ですが、 ai_protocol メンバーの一般的な値を示しています。

値 意味
IPPROTO_TCP
6
 伝送制御プロトコル (TCP)。 これは、ai_family メンバーがAF_INETまたはAF_INET6で、ai_socktype メンバーがSOCK_STREAMされている場合に使用できる値です。
IPPROTO_UDP
17
 ユーザー データグラム プロトコル (UDP)。 これは、ai_family メンバーがAF_INETまたはAF_INET6で、型パラメーターがSOCK_DGRAMされている場合に使用できる値です。
IPPROTO_RM
113
 信頼性の高いマルチキャスト用の PGM プロトコル。 これは、ai_family メンバーがAF_INETされ、ai_socktype メンバーがSOCK_RDM場合に使用できる値です。 Windows Vista 以降用にリリースされたWindows SDKでは、この値は IPPROTO_PGM とも呼ばれます。
 

ai_family メンバーがAF_IRDA場合、ai_protocolは 0 である必要があります。

ai_addrlen

ai_addr メンバーが指すバッファーの長さ (バイト単位)。

ai_canonname

ホストの正規名。

ai_addr

sockaddr 構造体へのポインター。 返される各 addrinfoex4 構造体のai_addr メンバーは、入力されたソケット アドレス構造体を指します。 返される各 addrinfoex4 構造体の長さ (バイト単位) は 、ai_addrlen メンバーで指定されます。

ai_blob

アドレスの一覧を超える名前に関連付けられているプロバイダー固有の名前空間情報を返すために使用されるデータへのポインター。 ai_blobが指すバッファーの長さ (バイト単位) は、ai_bloblen メンバーで指定する必要があります。

ai_bloblen

ai_blob メンバーの長さ (バイト単位)。

ai_provider

特定の名前空間プロバイダーの GUID へのポインター。

ai_next

リンク リスト内の次の構造体へのポインター。 このパラメーターは、リンク リストの最後の addrinfoex4 構造体で NULL に設定されます。

ai_version

この構造体のバージョン番号。 このバージョンの構造体に現在使用されている値は 4 です。

ai_fqdn

ホストの完全修飾ドメイン名。

ai_interfaceindex

IP_ADAPTER_ADDRESSESで定義されているインターフェイス インデックス。GetAdaptersAddresses で返される IfIndex プロパティ。

ai_resolutionhandle

ホストの完全修飾ドメイン名を指すハンドル。

注釈

addrinfoex4 構造体は、Windows 10とWindows Server 2016でサポートされています

addrinfoex4 構造体は、GetAddrInfoEx を介して渡された addrinfoex4.ai_flags メンバーでAI_EXTENDED | AI_FQDN | AI_CANONNAME | AI_RESOLUTION_HANDLE ビットが設定されている場合にホスト アドレス情報を保持するために GetAddrInfoEx 関数によって使用されます。hints パラメーター。

addrinfoex4 構造体は、正規名、ホストの完全修飾ドメイン名、および完全修飾ドメイン名へのハンドルを返すことができる拡張バージョンの addrinfoex 構造体です。 さらに、GetAddrInfoEx は、getaddrinfo および GetAddrInfoW 関数で使用される addrinfo および addrinfoW 構造体の拡張バージョンです。 GetAddrInfoEx 関数を使用すると、名前空間プロバイダーを指定してクエリを解決できます。 IPv6 および IPv4 プロトコルで使用する場合、名前解決には、ドメイン ネーム システム (DNS)、ローカル ホスト ファイル、電子メール プロバイダー ( NS_EMAIL 名前空間)、またはその他の名前付けメカニズムを使用できます。

ai_blob メンバー内の BLOB データは、名前に関連付けられている追加のプロバイダー固有の名前空間情報を返すために使用されます。 ai_blob メンバー内のデータの形式は、特定の名前空間プロバイダーに固有です。 現時点では、BLOB データは 、NS_EMAIL 名前空間プロバイダーによって追加情報を提供するために使用されます。

UNICODE または_UNICODEが定義されている場合、 addrinfoex4 は、この構造体の Unicode バージョンである addrinfoex4W に定義されます。 文字列パラメーターは PWSTR データ型に定義され、 addrinfoex4W 構造体が使用されます。

UNICODE または_UNICODEが定義されていない場合、 addrinfoex4 は、この構造体の ANSI バージョンである addrinfoex4A に定義されます。 文字列パラメーターは char * データ型で、 addrinfoex4A 構造体が使用されます。

GetAddrInfoEx を正常に呼び出すと、GetAddrInfoEx 関数に渡される ppResult パラメーターに addrinfoex4 構造体のリンクされたリストが返されます。 リストは、NULL ポインターが検出されるまで、返された各 addrinfoex4 構造体のai_next メンバーに指定されたポインターに従って処理できます。 返される各 addrinfoex4 構造体では、 ai_family、 ai_socktype、 および ai_protocol メンバーは 、 ソケット または WSASocket 関数呼び出しのそれぞれの引数に対応します。 また、返される各 addrinfoex4 構造体のai_addr メンバーは、入力されたソケット アドレス構造体を指し、その長さは ai_addrlen メンバーで指定されます。

例

次のコードでは、addrinfoex4 構造体を使用して GetAddrInfoEx を呼び出して、FQDN へのハンドルを取得する方法について説明します。 次に、このサンプルでは、ASSOCIATE_NAMERES_CONTEXT_INPUT構造体を使用して WSAIoctl を呼び出します。

// 
// Connect to a server using its IPv4 addresses 
// 

VOID 
ConnectServer( 
    PCWSTR server) 
{ 
    int iResult; 
    PADDRINFOEX4 pResult = NULL; 
    ADDRINFOEX3 hints = { 0 }; 
    PADDRINFOEX4 pCur = NULL; 
    WSADATA wsaData; 
    SOCKET connectSocket = INVALID_SOCKET; 
    ULONG bytesReturned = 0; 
    ASSOCIATE_NAMERES_CONTEXT_INPUT input = { 0 }; 
    SOCKADDR_IN clientService; 
    wchar_t ipstringbuffer[46]; 
    String string; 
    DWORD dwRetval; 
    //  
    //  Initialize Winsock 
    // 
    iResult = WSAStartup( 
        MAKEWORD(2, 2),  
        &wsaData); 
    if (iResult != 0) { 
        printf("WSAStartup failed: %d\n", iResult); 
        goto Exit; 
    } 

    //  
    // Create a SOCKET for connection 
    // 
    connectSocket = socket( 
        AF_UNSPEC,  
        SOCK_STREAM,  
        IPPROTO_TCP); 
    if (connectSocket == INVALID_SOCKET)  
    { 
        printf("socket failed: %d\n", WSAGetLastError()); 
        goto Exit; 
    } 

    // 
    // Do name resolution 
    // 

    hints.ai_family = AF_INET; 
    hints.ai_socktype = SOCK_STREAM; 
    hints.ai_flags = AI_EXTENDED | AI_FQDN | AI_CANONNAME | AI_RESOLUTION_HANDLE; 
    hints.ai_version = ADDRINFOEX_VERSION_4; 

    dwRetval = GetAddrInfoExW( 
        server, 
        NULL, 
        NS_DNS, 
        NULL, 
        (const ADDRINFOEXW*)&hints, 
        (PADDRINFOEXW*)&pResult, 
        NULL, 
        NULL, 
        NULL, NULL); 
    if (dwRetval != 0) { 
        printf("GetAddrInfoEx failed with error: %d\n", dwRetval); 
        goto Exit; 
    } 
    input.TransportSettingId.Guid = ASSOCIATE_NAMERES_CONTEXT; 
    input.Handle = pResult->ai_resolutionhandle; 

    // 
    // Associate socket with the handle 
    // 

    if (WSAIoctl( 
            connectSocket, 
            SIO_APPLY_TRANSPORT_SETTING, 
            (VOID *)&input, 
            sizeof(input), 
            NULL, 
            0, 
            &bytesReturned, 
            NULL, 
            NULL) == SOCKET_ERROR) 
    if (iResult != 0){ 
        printf("WSAIoctl failed: %d\n", WSAGetLastError()); 
        goto Exit; 
    }     

    // 
    // Connect to server 
    // 

    pCur = pResult; 
    while (pCur != NULL) 
    { 
        if (pCur->ai_addr->sa_family == AF_INET) 
        { 
            clientService = *(const sockaddr_in*)pCur->ai_addr; 
            clientService.sin_port = htons(80); 
            if (connect( 
                connectSocket, 
                (const SOCKADDR *)&clientService, 
                sizeof(clientService)) == SOCKET_ERROR) 
            { 
                printf("connect failed: %d\n", WSAGetLastError()); 
                goto Exit; 
            } 
        } 
        pCur = pCur->ai_next; 
    } 

Exit: 

    if (connectSocket != INVALID_SOCKET) 
    { 
        closesocket(connectSocket); 
    } 
    if (pResult) 
    { 
        FreeAddrInfoExW((ADDRINFOEXW*)pResult); 
    } 
    WSACleanup(); 
    return; 
}

要件

要件 値
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
Header ws2def.h

こちらもご覧ください

GetAddrInfoEx

addrinfo

addrinfoW

addrinfoex

addrinfoex3