ADDRINFOEX6結構 （ws2def.h）

GetAddrInfoEx 函式會使用 addrinfoex4 結構，以在要求特定網路介面時保存主機地址資訊。

語法

typedef struct addrinfoex6 {
  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;
  unsigned int        ai_numservers;
  ADDRINFO_DNS_SERVER *ai_servers;
  ULONG64             ai_responseflags;
} ADDRINFOEX6, *PADDRINFOEX6;

成員

ai_flags

指出 getAddrInfoEx 函式中所使用 選項的旗標。

ai_flags 成員的支援值定義於 Winsock2.h include 檔案中，而且可以是下列選項的組合。

ai_family

位址系列。

位址系列可能的值定義於 Ws2def.h 頭檔中。 請注意，Ws2def.h 頭文件會自動包含在 Winsock2.h中，而且不應該直接使用。

目前支援的值是 AF_INET 或 AF_INET6，這是 IPv4 和 IPv6 的因特網位址系列格式。 如果已安裝位址系列 Windows Sockets 服務提供者，則支援位址系列的其他選項（例如，AF_NETBIOS 與 NetBIOS 搭配使用）。 請注意，AF_位址系列和PF_通訊協定系列常數的值相同（例如，AF_INET 和 PF_INET），因此可以使用任一常數。

下表列出位址家族的常見值，但可能有許多其他值。

ai_socktype

套接字類型。 套接字類型的可能值定義於 Winsock2.h include 檔案中。

下表列出 Windows Sockets 2 支援的套接字型態可能值：

在 Windows Sockets 2 中，引進了新的套接字類型。 應用程式可以透過 WSAEnumProtocols 函式，動態探索每個可用傳輸通訊協議的屬性。 因此，應用程式可以判斷位址系列可能的套接字類型和通訊協定選項，並在指定此參數時使用這項資訊。 Winsock2.h 和 Ws2def.h 頭檔中的套接字類型定義將會定期更新，因為定義了新的套接字類型、位址系列和通訊協定。

在 Windows Sockets 1.1 中，唯一可能的套接字類型是 SOCK_DATAGRAM 和 SOCK_STREAM。

ai_protocol

通訊協定類型。 可能的選項專屬於指定的位址系列和套接字類型。 ai_protocol 的可能值定義於 winsock2.h 和 Wsrm.h 頭檔中。

在 Windows Vista 和更新版本的 Windows SDK 上，頭文件的組織已變更，而且此成員可以是 IPPROTO 列舉類型中定義的其中一個值，Ws2def.h 頭檔。 請注意，Ws2def.h 頭文件會自動包含在 Winsock2.h中，而且不應該直接使用。

如果針對 ai_protocol指定了 0 值，則呼叫端不想要指定通訊協議，服務提供者會選擇要使用的 ai_protocol。 針對 IPv4 和 IPv6 以外的通訊協定，請將 ai_protocol 設為零。

下表列出 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 記錄有效秒數。

ai_numservers

ai_servers 成員中存在的自定義 DNS 伺服器數目。

ai_servers

N 的陣列（其中 N == ai_numservers） ADDRINFO_DNS_SERVER 物件。 如果 ai_numservers 為 0，則必須 NULLai_servers。

ai_responseflags

傳回位圖，其中包含下列任何值。

言論

ADDRINFOEX6 結構是 ADDRINFOEX5 結構的延伸。 除了 ADDRINFOEX5 結構中的所有欄位之外，它也會保存 ai_numservers 和 ai_servers 成員，以啟用自定義個別查詢 DNS 伺服器。 它也會保存 ai_responseflags 成員，其中包含 DNS 回應來源的相關信息。

如果 AI_RETURN_RESPONSE_FLAGS 旗標存在於 ai_flags 成員中，GetAddrInfoExppResult 參數會傳回 ADDRINFOEX6 結構清單，其中 ai_responseflags 成員會包含 DNS 結果來源的相關信息。

如果 ai_numservers 和 ai_servers 成員指向有效 ADDRINFO_DNS_SERVER 物件的陣列，則 DNS 查詢會將這些伺服器新增為系統設定的 DNS 伺服器後援。 如果 AI_EXCLUSIVE_CUSTOM_SERVERS 選項存在於 ai_flags 成員中，則 DNS 查詢將獨佔使用自定義伺服器。

例子

請參閱 ADDRINFOEX4 結構主題中的範例程序代碼。

要求

另請參閱

GetAddrInfoEx

addrinfo

addrinfoW

addrinfoex

addrinfoex3