ADDRINFOEX3構造体 (ws2def.h)

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

構文

typedef struct addrinfoex3 {
  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;
  LPGUID             ai_provider;
  struct addrinfoex3 *ai_next;
  int                ai_version;
  PWSTR              ai_fqdn;
  int                ai_interfaceindex;
} ADDRINFOEX3, *PADDRINFOEX3, *LPADDRINFOEX3;

メンバー

ai_flags

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

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

ai_family

アドレス ファミリ。

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

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

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

ai_socktype

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

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

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 メンバーの一般的な値を示しています。

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

ai_addrlen

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

ai_canonname

ホストの正規名。

ai_addr

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

ai_blob

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

ai_bloblen

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

ai_provider

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

ai_next

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

ai_version

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

ai_fqdn

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

ai_interfaceindex

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

注釈

addrinfoex3 構造体は、Windows 8.1 および Windows Server 2012 R2 でサポートされています

addrinfoex3 構造体は、addrinfoex3 で AI_EXTENDED | AI_FQDN AI_CANONNAME | ビットが設定されている場合にホスト アドレス情報を保持するために GetAddrInfoEx 関数によって使用されます。GetAddrInfoEx を介して渡されたメンバー ai_flagsします。hints パラメーター。 addrinfoex3 も設定する必要があります。情報を取得するインターフェイスにメンバーをai_interfaceindexし、3 にai_versionします。

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

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

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

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

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

要件

こちらもご覧ください

GetAddrInfoEx

addrinfo

addrinfoW

addrinfoex