ADDRINFOEX5 Struktur (ws2def.h)

Artikel
07/16/2024

Die addrinfoex4- Struktur wird von der GetAddrInfoEx--Funktion verwendet, um Hostadresseninformationen zu enthalten, wenn eine bestimmte Netzwerkschnittstelle angefordert wurde.

Syntax

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;

Angehörige

ai_flags

Flags, die Optionen angeben, die in der GetAddrInfoEx--Funktion verwendet werden.

Unterstützte Werte für das ai_flags-Element werden in der Winsock2.h enthaltene Datei definiert und können eine Kombination der folgenden Optionen sein.

Wert	Bedeutung
AI_PASSIVE 0x01	Die Socketadresse wird in einem Aufruf der BindungFunktion verwendet.
AI_CANONNAME 0x02	Der kanonische Name wird im ersten ai_canonname-Element zurückgegeben.
AI_NUMERICHOST 0x04	Der Knotenname Parameter, der an die GetAddrInfoEx- funktion übergeben wird, muss eine numerische Zeichenfolge sein.
AI_ALL 0x0100	Wenn dieses Bit festgelegt ist, wird eine Anforderung für IPv6-Adressen und IPv4-Adressen mit AI_V4MAPPEDgestellt. Diese Option wird unter Windows Vista und höher unterstützt.
AI_ADDRCONFIG 0x0400	Die GetAddrInfoEx- wird nur aufgelöst, wenn eine globale Adresse konfiguriert ist. Die IPv6- und IPv4-Loopbackadresse gilt nicht als gültige globale Adresse. Diese Option wird unter Windows Vista und höher unterstützt.
AI_V4MAPPED 0x0800	Wenn die GetAddrInfoEx- Anforderung für IPv6-Adressen fehlschlägt, wird eine Namensdienstanforderung für IPv4-Adressen gestellt, und diese Adressen werden in das IPv4-zugeordnete IPv6-Adressformat konvertiert. Diese Option wird unter Windows Vista und höher unterstützt.
AI_NON_AUTHORITATIVE 0x04000	Die Adressinformationen stammen aus nicht autoritativen Ergebnissen. Wenn diese Option im pHints Parameter von GetAddrInfoExfestgelegt wird, gibt der NS_EMAIL Namespaceanbieter sowohl autorisierende als auch nicht autorisierende Ergebnisse zurück. Wenn diese Option nicht festgelegt ist, werden nur autorisierende Ergebnisse zurückgegeben. Diese Option wird nur unter Windows Vista und höher für den NS_EMAIL Namespace unterstützt.
AI_SECURE 0x08000	Die Adressinformationen stammen aus einem sicheren Kanal. Wenn das AI_SECURE Bit festgelegt ist, gibt der NS_EMAIL Namespaceanbieter Ergebnisse zurück, die mit verbesserter Sicherheit abgerufen wurden, um mögliche Spoofing zu minimieren. Wenn diese Option im pHints Parameter von GetAddrInfoExfestgelegt wird, gibt der NS_EMAIL Namespaceanbieter nur Ergebnisse zurück, die mit erweiterter Sicherheit abgerufen wurden, um mögliche Spoofing zu minimieren. Diese Option wird nur unter Windows Vista und höher für den NS_EMAIL Namespace unterstützt.
AI_RETURN_PREFERRED_NAMES 0x010000	Die Adressinformationen beziehen sich auf bevorzugte Namen für die Publikation mit einem bestimmten Namespace. Wenn diese Option im pHints Parameter von GetAddrInfoExfestgelegt wird, sollte kein Name im pName--Parameter angegeben werden, und der NS_EMAIL Namespaceanbieter gibt bevorzugte Namen für die Publikation zurück. Diese Option wird nur unter Windows Vista und höher für den NS_EMAIL Namespace unterstützt.
AI_FQDN 0x00020000	Der vollqualifizierte Domänenname wird im ersten ai_fqdn Mitglied zurückgegeben. Wenn diese Option im pHints Parameter von GetAddrInfoEx und im pName Parameter ein Flachname (einzelne Bezeichnung) angegeben wird, wird der vollqualifizierte Domänenname zurückgegeben, zu dem der Name schließlich aufgelöst wird. Diese Option wird unter Windows 7, Windows Server 2008 R2 und höher unterstützt.
AI_FILESERVER 0x00040000	Ein Hinweis auf den Namespaceanbieter, der abgefragt wird, wird in einem Dateifreigabeszenario verwendet. Dieser Hinweis kann vom Namespaceanbieter ignoriert werden. Diese Option wird unter Windows 7, Windows Server 2008 R2 und höher unterstützt.
AI_DISABLE_IDN_ENCODING 0x00080000	Deaktivieren Sie die automatische Codierung des internationalen Domänennamens 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_EXTENDED 0x80000000	Gibt an, dass das aktuelle Objekt erweitert wird: d. h. ein addrinfoex2 oder höher. Diese Option wird unter Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
AI_RESOLUTION_HANDLE 0x40000000	Ein Lösungshandle wird im ai_resolutionhandle Member zurückgegeben. Diese Option wird unter Windows 10, Windows Server 2016 und höher unterstützt.
AI_RETURN_TTL 0x0080	Die Anzahl der Sekunden, für die der DNS-Eintrag gültig ist. Wenn dieses Flag vorhanden ist, GetAddrInfoEx.ppResult Parameter gibt eine Liste addrinfoex5- Strukturen zurück, in denen das ai_ttl Mitglied die einzelne TTL des DNS-Eintrags enthält.

ai_family

Die Adressfamilie.

Die möglichen Werte für die Adressfamilie werden in der Ws2def.h Headerdatei definiert. Beachten Sie, dass die Ws2def.h Headerdatei automatisch in Winsock2.henthalten ist und niemals direkt verwendet werden sollte.

Die derzeit unterstützten Werte werden AF_INET oder AF_INET6, die internetadressfamilienformate für IPv4 und IPv6 sind. Andere Optionen für 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.

Wert	Bedeutung
AF_UNSPEC 0	Die Adressfamilie ist nicht angegeben.
AF_INET 2	Die Internetprotokoll-Adressfamilie Version 4 (IPv4).
AF_NETBIOS 17	Die NetBIOS-Adressfamilie. Diese Adressfamilie wird nur unterstützt, wenn ein Windows Sockets-Anbieter für NetBIOS installiert ist.
AF_INET6 23	Die Internetprotokoll-Adressfamilie Version 6 (IPv6).
AF_IRDA 26	Die IrDA-Adressfamilie (Infrarot Data Association). Diese Adressfamilie wird nur unterstützt, wenn der Computer über einen Infrarotanschluss und treiber verfügt.
AF_BTH 32	Die Bluetooth-Adressfamilie. Diese Adressfamilie wird nur unterstützt, wenn ein Bluetooth-Adapter installiert ist.

ai_socktype

Der Sockettyp. Mögliche Werte für den Sockettyp werden in der Winsock2.h enthaltene Datei 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
SOCK_STREAM 1	Stellt sequenzierte, zuverlässige, bidirektionale, verbindungsbasierte Bytestreams mit einem OOB-Datenübertragungsmechanismus bereit. Verwendet das Transmission Control Protocol (TCP) für die Internetadressenfamilie (AF_INET oder AF_INET6). Wenn das ai_family Mitglied AF_IRDAist, ist SOCK_STREAM der einzige unterstützte Sockettyp.
SOCK_DGRAM 2	Unterstützt Datagramme, die verbindungslose, unzuverlässige Puffer einer festen (normalerweise kleinen) maximalen Länge sind. Verwendet das User Datagram Protocol (UDP) für die Internetadressenfamilie (AF_INET oder AF_INET6).
SOCK_RAW 3	Stellt einen unformatierten Socket bereit, der es einer Anwendung ermöglicht, den nächsten Protokollheader der oberen Ebene zu bearbeiten. Um den IPv4-Header zu bearbeiten, muss die IP_HDRINCL Socketoption für den Socket festgelegt werden. Um den IPv6-Header zu bearbeiten, muss die IPV6_HDRINCL Socketoption für den Socket festgelegt werden.
SOCK_RDM 4	Stellt ein zuverlässiges Nachrichtendatendiagramm bereit. Ein Beispiel für diesen Typ ist die Pragmatische Multicast-Multicast(PGM)-Multicastprotokollimplementierung in Windows, die häufig als zuverlässige Multicastprogrammierungbezeichnet wird.
SOCK_SEQPACKET 5	Stellt ein Pseudodatenstrompaket basierend auf Datagrammen bereit.

In Windows Sockets 2 wurden neue Sockettypen eingeführt. Eine Anwendung kann die Attribute jedes verfügbaren Transportprotokolls dynamisch über die WSAEnumProtocols-Funktion ermitteln. Daher kann eine Anwendung die möglichen Sockettyp- und Protokolloptionen für eine Adressfamilie bestimmen und diese Informationen verwenden, wenn Sie diesen Parameter angeben. Sockettypdefinitionen in der Winsock2.h und Ws2def.h Headerdateien werden regelmäßig aktualisiert, wenn neue Sockettypen, Adressfamilien und Protokolle definiert sind.

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, hat sich die Organisation von Headerdateien geändert, und dieses Mitglied kann einer der Werte aus dem IPPROTO- Enumerationstyp sein, der in der Ws2def.h Headerdatei definiert ist. Beachten Sie, dass die Ws2def.h Headerdatei automatisch in Winsock2.henthalten ist und niemals direkt verwendet werden sollte.

Wenn für ai_protocolein Wert von 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 das ai_protocol-Element aufgeführt, obwohl viele andere Werte möglich sind.

Wert	Bedeutung
IPPROTO_TCP 6	Das Transmission Control Protocol (TCP). Dies ist ein möglicher Wert, wenn das ai_family-Element AF_INET oder AF_INET6 ist und das ai_socktype-Element SOCK_STREAMist.
IPPROTO_UDP 17	Das User Datagram Protocol (UDP). Dies ist ein möglicher Wert, wenn das ai_family-Element AF_INET oder AF_INET6 ist und der Typ Parameter SOCK_DGRAMist.
IPPROTO_RM 113	Das PGM-Protokoll für zuverlässige Multicasts. Dies ist ein möglicher Wert, wenn das ai_family Mitglied AF_INET und das ai_socktype Mitglied SOCK_RDMist. Auf dem für Windows Vista und höher veröffentlichten Windows SDK wird dieser Wert auch als IPPROTO_PGMbezeichnet.

Wenn das ai_family Mitglied AF_IRDAist, muss die ai_protocol 0 sein.

ai_addrlen

Die Länge des Puffers in Byte, auf den das ai_addr-Element verweist.

ai_canonname

Der kanonische Name für den Host.

ai_addr

Ein Zeiger auf eine sockaddr- Struktur. Das ai_addr Element in jedem zurückgegebenen addrinfoex4 Struktur verweist auf eine gefüllte Socketadressenstruktur. Die Länge jedes zurückgegebenen addrinfoex4- Struktur in Byte wird im ai_addrlen-Element 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, auf den ai_blob verweist, muss im ai_bloblen-Element angegeben werden.

ai_bloblen

Die Länge des ai_blob Elements in Byte.

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 wird auf NULL- in der letzten addrinfoex4 Struktur einer verknüpften Liste festgelegt.

ai_version

Die Versionsnummer dieser Struktur. Der aktuell für diese Version der Struktur verwendete Wert ist 4.

ai_fqdn

Der vollqualifizierte Domänenname für den Host.

ai_interfaceindex

Der Schnittstellenindex, wie vom IP_ADAPTER_ADDRESSESdefiniert.IfIndex-Eigenschaft, die in GetAdaptersAddresseszurückgegeben wird.

ai_resolutionhandle

Behandeln Sie das Verweisen auf den vollqualifizierten Domänennamen für den Host.

ai_ttl

Die Anzahl der Sekunden, für die dieser DNS-Eintrag gültig ist.

Bemerkungen

Die ADDRINFOEX5 Struktur wird von der GetAddrInfoExW--Funktion verwendet, um Hostadresseninformationen zu enthalten, wenn die AI_EXTENDED oder AI_RETURN_TTL Bits im ai_flags Member festgelegt werden, der über die GetAddrInfoExWHinweise Parameter übergeben wird.

Die ADDRINFOEX5 Struktur ist eine Erweiterung der ADDRINFOEX4 Struktur. Zusätzlich zu allen Feldern aus der ADDRINFOEX4-Struktur enthält sie auch im ai_ttl Member die einzelnen DNS-TTL für jede zurückgegebene IP-Adresse.

Wenn das AI_RETURN_TTL Bit im ai_flags Member festgelegt ist, das über die GetAddrInfoExHinweis Parameter übergeben wird, gibt der GetAddrInfoExWppResult Parameter eine Liste ADDRINFOEX5 Strukturen zurück. Jeder Knoten in dieser Liste enthält im ai_ttl Mitglied den einzelnen DNS-TTL für die IP-Adresse, die im sockaddr Mitglied vorhanden ist.