ADDRINFOEX5構造体 (ws2def.h)

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

構文

typedef struct addrinfoex5 {
  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 addrinfoex5 *ai_next;
  int                ai_version;
  PWSTR              ai_fqdn;
  int                ai_interfaceindex;
  HANDLE             ai_resolutionhandle;
  unsigned int       ai_ttl;
} ADDRINFOEX5, *PADDRINFOEX5, *LPADDRINFOEX5;

メンバーズ

ai_flags

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

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

ai_family

アドレス ファミリ。

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

現在サポートされている値は AF_INET または AF_INET6です。これは、IPv4 および IPv6 のインターネット アドレス ファミリ形式です。 アドレス ファミリの 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 では、ヘッダー ファイルの編成が変更され、このメンバーは、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 構造体へのポインター。 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

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

ai_ttl

この DNS レコードが有効な秒数。

備考

ADDRINFOEX5 構造体は、GetAddrInfoExW 関数によって使用され、AI_EXTENDED または AI_RETURN_TTL ビットが、GetAddrInfoExWヒント パラメーターを介して渡された ai_flags メンバーに設定されている場合にホスト アドレス情報を保持します。

ADDRINFOEX5 構造体は、ADDRINFOEX4 構造体の拡張です。 ADDRINFOEX4 構造体のすべてのフィールドに加えて、ai_ttl メンバーには、返された各 IP アドレスの個々の DNS TTL も保持されます。

GetAddrInfoExヒント パラメーターを介して渡された ai_flags メンバーで AI_RETURN_TTL ビットが設定されている場合、GetAddrInfoExWppResult パラメーターは、ADDRINFOEX5 構造体の一覧を返します。 この一覧の各ノードは、ai_ttl メンバーに、sockaddr メンバーに存在する IP アドレスの個々の DNS TTL を含みます。

例

ADDRINFOEX4 構造のトピックのコード例を参照してください。

必要条件

関連項目

GetAddrInfoEx を する

addrinfo を する

addrinfoW を する

addrinfoex を する

addrinfoex3 を する