ADDRINFOEX2W-Struktur (ws2def.h)
Die addrinfoex2-Struktur wird von der GetAddrInfoEx-Funktion verwendet, um Hostadresseninformationen zu enthalten, wenn sowohl ein kanonischer Name als auch ein vollqualifizierter Domänenname angefordert wurden.
Syntax
typedef struct addrinfoex2W {
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 addrinfoex2W *ai_next;
int ai_version;
PWSTR ai_fqdn;
} ADDRINFOEX2W, *PADDRINFOEX2W, *LPADDRINFOEX2W;
Member
ai_flags
Flags, die optionen angeben, die in der GetAddrInfoEx-Funktion verwendet werden.
Unterstützte Werte für das ai_flags-Member werden in der Winsock2.h-Includedatei definiert und können eine Kombination aus den folgenden Optionen sein.
| Wert | Bedeutung |
|---|---|
|
Die Socketadresse wird in einem Aufruf der Bindfunktion verwendet. |
|
Der kanonische Name wird im ersten ai_canonname Member zurückgegeben. |
|
Der an die GetAddrInfoEx-Funktion übergebene nodename-Parameter muss eine numerische Zeichenfolge sein. |
|
Wenn dieses Bit festgelegt ist, wird eine Anforderung für IPv6-Adressen und IPv4-Adressen mit AI_V4MAPPED.
Diese Option wird unter Windows Vista und höher unterstützt. |
|
GetAddrInfoEx wird nur aufgelöst, wenn eine globale Adresse konfiguriert ist. Die IPv6- und IPv4-Loopbackadresse wird nicht als gültige globale Adresse betrachtet.
Diese Option wird unter Windows Vista und höher unterstützt. |
|
Wenn die GetAddrInfoEx-Anforderung für eine IPv6-Adresse fehlschlägt, wird eine Namensdienstanforderung für IPv4-Adressen erstellt, und diese Adressen werden in das IPv4-zugeordnete IPv6-Adressformat konvertiert.
Diese Option wird unter Windows Vista und höher unterstützt. |
|
Die Adressinformationen stammen aus nicht autoritativen Ergebnissen.
Wenn diese Option im pHints-Parameter von GetAddrInfoEx festgelegt ist, gibt der NS_EMAIL-Namespaceanbieter sowohl autorisierende als auch nicht autorisierende Ergebnisse zurück. Wenn diese Option nicht festgelegt ist, werden nur autoritative Ergebnisse zurückgegeben. Diese Option wird nur unter Windows Vista und höher für den NS_EMAIL-Namespace unterstützt. |
|
Die Adressinformationen stammen aus einem sicheren Kanal.
Wenn das AI_SECURE Bit festgelegt ist, gibt der NS_EMAIL-Namespaceanbieter Ergebnisse zurück, die mit erhöhter Sicherheit abgerufen wurden, um mögliche Spoofings zu minimieren. Wenn diese Option im pHints-Parameter von GetAddrInfoEx festgelegt ist, gibt der NS_EMAIL-Namespaceanbieter nur Ergebnisse zurück, die mit erhöhter Sicherheit abgerufen wurden, um mögliche Spoofings zu minimieren. Diese Option wird nur unter Windows Vista und höher für den NS_EMAIL-Namespace unterstützt. |
|
Die Adressinformationen gelten für einen bevorzugten Namen für die Veröffentlichung mit einem bestimmten Namespace.
Wenn diese Option im pHints-Parameter von GetAddrInfoEx festgelegt ist, sollte kein Name im pName-Parameter angegeben werden, und der NS_EMAIL Namespaceanbieter gibt bevorzugte Namen für die Veröffentlichung zurück. Diese Option wird nur unter Windows Vista und höher für den NS_EMAIL-Namespace unterstützt. |
|
Der vollqualifizierte Domänenname wird im ersten ai_fqdn Member zurückgegeben.
Wenn diese Option im pHints-Parameter von GetAddrInfoEx festgelegt ist und im pName-Parameter ein Flachname (einzelne Bezeichnung) angegeben wird, wird der vollqualifizierte Domänenname zurückgegeben, in den der Name schließlich aufgelöst wurde. Diese Option wird unter Windows 7, Windows Server 2008 R2 und höher unterstützt. |
|
Ein Hinweis an den Namespaceanbieter, dass der abgefragte Hostname in einem Dateifreigabeszenario verwendet wird. Der Namespaceanbieter ignoriert diesen Hinweis möglicherweise.
Diese Option wird unter Windows 7, Windows Server 2008 R2 und höher unterstützt. |
|
Deaktivieren Sie die automatische internationale Domänennamencodierung mithilfe von Punycode in den Namensauflösungsfunktionen, die von der GetAddrInfoEx-Funktion aufgerufen werden.
Diese Option wird unter Windows 8, Windows Server 2012 und höher unterstützt. |
ai_family
Die Adressfamilie.
Die möglichen Werte für die Adressfamilie sind in der Ws2def.h-Headerdatei definiert. Beachten Sie, dass die Ws2def.h-Headerdatei automatisch in Winsock2.h enthalten ist und niemals direkt verwendet werden sollte.
Die derzeit unterstützten Werte sind AF_INET oder AF_INET6, d. h. die Internetadressfamilienformate für IPv4 und IPv6. Andere Optionen für die Adressfamilie (AF_NETBIOS für die Verwendung mit NetBIOS, z. B.) werden unterstützt, wenn ein Windows Sockets-Dienstanbieter für die Adressfamilie installiert ist. Beachten Sie, dass die Werte für die AF_ Adressfamilie und PF_ Protokollfamilienkonstanten identisch sind (z. B. AF_INET und PF_INET), sodass beide Konstanten verwendet werden können.
In der folgenden Tabelle sind allgemeine Werte für die Adressfamilie aufgeführt, obwohl viele andere Werte möglich sind.
ai_socktype
Der Sockettyp. Mögliche Werte für den Sockettyp sind in der Includedatei Winsock2.h definiert.
In der folgenden Tabelle sind die möglichen Werte für den für Windows Sockets 2 unterstützten Sockettyp aufgeführt:
| Wert | Bedeutung |
|---|---|
|
Stellt sequenzierte, zuverlässige, bidirektionale, verbindungsbasierte Bytedatenströme mit einem OOB-Datenübertragungsmechanismus bereit. Verwendet tcp (Transmission Control Protocol) für die Internetadressenfamilie (AF_INET oder AF_INET6). Wenn der ai_family-MemberAF_IRDA ist, ist SOCK_STREAM der einzige unterstützte Sockettyp. |
|
Unterstützt Datagramme, bei denen es sich um verbindungslose, unzuverlässige Puffer mit einer festen (in der Regel kleinen) maximalen Länge handelt. Verwendet das User Datagram Protocol (UDP) für die Internetadressenfamilie (AF_INET oder AF_INET6). |
|
Stellt einen rohen Socket bereit, mit dem eine Anwendung den nächsten Protokollheader der oberen Ebene bearbeiten kann. Zum Bearbeiten des IPv4-Headers muss die IP_HDRINCL-Socketoption für den Socket festgelegt werden. Zum Bearbeiten des IPv6-Headers muss die IPV6_HDRINCL-Socketoption für den Socket festgelegt werden. |
|
Stellt ein zuverlässiges Nachrichtendatengramm bereit. Ein Beispiel für diesen Typ ist die PGM-Multicastprotokollimplementierung (Pragmatic General Multicast) in Windows, die häufig als zuverlässige Multicastprogrammierung bezeichnet wird. |
|
Stellt ein Pseudostreampaket basierend auf Datagrammen bereit. |
In Windows Sockets 2 wurden neue Sockettypen eingeführt. Eine Anwendung kann die Attribute jedes verfügbaren Transportprotokolls über die WSAEnumProtocols-Funktion dynamisch ermitteln. So kann eine Anwendung den möglichen Sockettyp und die Protokolloptionen für eine Adressfamilie ermitteln und diese Informationen beim Angeben dieses Parameters verwenden. Sockettypdefinitionen in den Headerdateien Winsock2.h und Ws2def.h werden regelmäßig aktualisiert, wenn neue Sockettypen, Adressfamilien und Protokolle definiert werden.
In Windows Sockets 1.1 sind die einzigen möglichen Sockettypen SOCK_DATAGRAM und SOCK_STREAM.
ai_protocol
Der Protokolltyp. Die möglichen Optionen sind spezifisch für die angegebene Adressfamilie und den angegebenen Sockettyp. Mögliche Werte für die ai_protocol werden in Winsock2.h und den Wsrm.h-Headerdateien definiert.
Im Windows SDK, das für Windows Vista und höher veröffentlicht wurde, wurde die organization von Headerdateien geändert, und dieser Member kann einer der Werte des IPPROTO-Enumerationstyps sein, der in der Ws2def.h-Headerdatei definiert ist. Beachten Sie, dass die Ws2def.h-Headerdatei automatisch in Winsock2.h enthalten ist und nie direkt verwendet werden sollte.
Wenn für ai_protocol der Wert 0 angegeben wird, möchte der Aufrufer kein Protokoll angeben, und der Dienstanbieter wählt die zu verwendende ai_protocol aus. Legen Sie für andere Protokolle als IPv4 und IPv6 ai_protocol auf Null fest.
In der folgenden Tabelle sind allgemeine Werte für den ai_protocol-Member aufgeführt, obwohl viele andere Werte möglich sind.
Wenn das ai_family-ElementAF_IRDA ist, muss die ai_protocol 0 sein.
ai_addrlen
Die Länge des Puffers in Bytes, auf den der ai_addr-Member verweist.
ai_canonname
Der kanonische Name für den Host.
ai_addr
Ein Zeiger auf eine sockaddr-Struktur . Das ai_addr-Member in jeder zurückgegebenen addrinfoex2-Struktur verweist auf eine ausgefüllte Socketadressstruktur. Die Länge jeder zurückgegebenen addrinfoex2-Struktur in Bytes wird im ai_addrlen-Member angegeben.
ai_blob
Ein Zeiger auf Daten, die verwendet werden, um anbieterspezifische Namespaceinformationen zurückzugeben, die dem Namen über eine Liste von Adressen hinaus zugeordnet sind. Die Länge des Puffers in Bytes, auf den ai_blob verweist, muss im ai_bloblen-Member angegeben werden.
ai_bloblen
Die Länge des ai_blob-Members in Bytes.
ai_provider
Ein Zeiger auf die GUID eines bestimmten Namespaceanbieters.
ai_next
Ein Zeiger auf die nächste Struktur in einer verknüpften Liste. Dieser Parameter ist in der letzten addrinfoex2-Struktur einer verknüpften Liste auf NULL festgelegt.
ai_version
Die Versionsnummer dieser Struktur. Der derzeit für diese Version der Struktur verwendete Wert ist 2.
ai_fqdn
Der vollqualifizierte Domänenname für den Host.
Hinweise
Die addrinfoex2-Struktur wird unter Windows 8 und Windows Server 2012 unterstützt.
Die addrinfoex2-Struktur wird von der GetAddrInfoEx-Funktion verwendet, um Hostadresseninformationen zu enthalten, wenn sowohl die AI_FQDN - als auch AI_CANONNAME Bits im ai_flags Member der optionalen addrinfoex-Struktur festgelegt sind, die im Hinweisparameter für die GetAddrInfoEx-Funktion bereitgestellt wird. Die addrinfoex2-Struktur ist eine erweiterte Version der addrinfoex-Struktur , die sowohl den kanonischen Namen als auch den vollqualifizierten Domänennamen für den Host zurückgeben kann. Die zusätzlichen Strukturmember gelten für eine Versionsnummer der Struktur und den vollqualifizierten Domänennamen für den Host.
Die addrinfoex2-Struktur , die mit der GetAddrInfoEx-Funktion verwendet wird, ist eine erweiterte Version der addrinfo - und addrinfoW-Strukturen , die mit den Funktionen getaddrinfo und GetAddrInfoW verwendet werden. Die GetAddrInfoEx-Funktion ermöglicht die Angabe des Namespaceanbieters zum Auflösen der Abfrage. Für die Verwendung mit dem IPv6- und IPv4-Protokoll kann die Namensauflösung durch das Domain Name System (DNS), eine lokale Hostdatei , einen E-Mail-Anbieter (der NS_EMAIL Namespace) oder durch andere Benennungsmechanismen erfolgen.
Die Blobdaten in ai_blob Member werden verwendet, um zusätzliche anbieterspezifische Namespaceinformationen zurückzugeben, die einem Namen zugeordnet sind. Das Format der Daten im ai_blob-Member ist für einen bestimmten Namespaceanbieter spezifisch. Derzeit werden Blobdaten vom NS_EMAIL Namespaceanbieter verwendet, um zusätzliche Informationen zur Verfügung zu stellen.
Wenn UNICODE oder _UNICODE definiert ist, wird addrinfoex2 für addrinfoex2W, die Unicode-Version dieser Struktur, definiert. Die Zeichenfolgenparameter werden für den PWSTR-Datentyp definiert, und die addrinfoex2W-Struktur wird verwendet.
Wenn UNICODE oder _UNICODE nicht definiert ist, wird addrinfoex2 für addrinfoex2A, die ANSI-Version dieser Struktur, definiert. Die Zeichenfolgenparameter sind vom Datentyp char * und die Struktur addrinfoex2A wird verwendet.
Nach einem erfolgreichen Aufruf von GetAddrInfoEx wird eine verknüpfte Liste von addrinfoex2-Strukturen im ppResult-Parameter zurückgegeben, der an die GetAddrInfoEx-Funktion übergeben wird. Die Liste kann verarbeitet werden, indem Sie dem Zeiger folgen, der im ai_next Member jeder zurückgegebenen addrinfoex2-Struktur bereitgestellt wird, bis ein NULL-Zeiger gefunden wird. In jeder zurückgegebenen addrinfoex2-Struktur entsprechen die ai_family, ai_socktype und ai_protocol Member den entsprechenden Argumenten in einem Socket- oder WSASocket-Funktionsaufruf . Außerdem verweist der ai_addr Member in jeder zurückgegebenen addrinfoex2-Struktur auf eine ausgefüllte Socketadressstruktur, deren Länge im ai_addrlen-Member angegeben ist.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Kopfzeile | ws2def.h |