structure ADDRINFOEX6 (ws2def.h)

Article
07/16/2024

La structure addrinfoex4 est utilisée par la fonction GetAddrInfoEx pour contenir les informations d’adresse de l’hôte lorsqu’une interface réseau spécifique a été demandée.

Syntaxe

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;

Membres

ai_flags

Indicateurs qui indiquent les options utilisées dans la fonction GetAddrInfoEx.

Les valeurs prises en charge pour le membre ai_flags sont définies dans le fichier include Winsock2.h et peuvent être une combinaison des options suivantes.

Valeur	Signification
AI_PASSIVE 0x01	L’adresse de socket est utilisée dans un appel à la fonction lier.
AI_CANONNAME 0x02	Le nom canonique est retourné dans le premier membre ai_canonname.
AI_NUMERICHOST 0x04	Le paramètre nodename passé à la fonction GetAddrInfoEx doit être une chaîne numérique.
AI_ALL 0x0100	Si ce bit est défini, une requête est effectuée pour les adresses IPv6 et les adresses IPv4 avec AI_V4MAPPED. Cette option est prise en charge sur Windows Vista et versions ultérieures.
AI_ADDRCONFIG 0x0400	La GetAddrInfoEx résout uniquement si une adresse globale est configurée. L’adresse de bouclage IPv6 et IPv4 n’est pas considérée comme une adresse globale valide. Cette option est prise en charge sur Windows Vista et versions ultérieures.
AI_V4MAPPED 0x0800	Si l'GetAddrInfoEx demande d’adresses IPv6 échoue, une demande de service de noms est effectuée pour les adresses IPv4 et ces adresses sont converties en format d’adresse IPv4 mappée IPv6. Cette option est prise en charge sur Windows Vista et versions ultérieures.
AI_NON_AUTHORITATIVE 0x04000	Les informations d’adresse proviennent de résultats non faisant autorité. Lorsque cette option est définie dans le paramètre pHints de GetAddrInfoEx, le fournisseur d’espaces de noms NS_EMAIL retourne les résultats faisant autorité et non faisant autorité. Si cette option n’est pas définie, seuls les résultats faisant autorité sont retournés. Cette option est uniquement prise en charge sur Windows Vista et versions ultérieures pour l’espace de noms NS_EMAIL.
AI_SECURE 0x08000	Les informations d’adresse proviennent d’un canal sécurisé. Si le bit AI_SECURE est défini, le fournisseur d’espaces de noms NS_EMAIL retourne les résultats obtenus avec une sécurité renforcée pour réduire au minimum l’usurpation possible. Lorsque cette option est définie dans le paramètre pHints de GetAddrInfoEx, le fournisseur d’espaces de noms NS_EMAIL retourne uniquement les résultats obtenus avec une sécurité renforcée afin de réduire au minimum l’usurpation possible. Cette option est uniquement prise en charge sur Windows Vista et versions ultérieures pour l’espace de noms NS_EMAIL.
AI_RETURN_PREFERRED_NAMES 0x010000	Les informations d’adresse concernent les noms préférés pour la publication avec un espace de noms spécifique. Lorsque cette option est définie dans le paramètre pHints de GetAddrInfoEx, aucun nom ne doit être fourni dans le paramètre pName et le fournisseur d’espaces de noms NS_EMAIL retourne les noms préférés pour la publication. Cette option est uniquement prise en charge sur Windows Vista et versions ultérieures pour l’espace de noms NS_EMAIL.
AI_FQDN 0x00020000	Le nom de domaine complet est retourné dans le premier membre ai_fqdn. Lorsque cette option est définie dans le paramètre pHints de GetAddrInfoEx et qu’un nom plat (étiquette unique) est spécifié dans le paramètre pName, le nom de domaine complet que le nom a finalement résolu sera retourné. Cette option est prise en charge sur Windows 7, Windows Server 2008 R2 et versions ultérieures.
AI_FILESERVER 0x00040000	Indicateur du fournisseur d’espaces de noms indiquant que le nom d’hôte interrogé est utilisé dans un scénario de partage de fichiers. Le fournisseur d’espaces de noms peut ignorer cet indicateur. Cette option est prise en charge sur Windows 7, Windows Server 2008 R2 et versions ultérieures.
AI_DISABLE_IDN_ENCODING 0x00080000	Désactivez l’encodage automatique de nom de domaine international à l’aide de Punycode dans les fonctions de résolution de noms appelées par la fonction GetAddrInfoEx. Cette option est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
AI_EXTENDED 0x80000000	Indique que l’objet actuel est étendu : autrement dit, un addrinfoex2 ou supérieur. Cette option est prise en charge sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.
AI_RESOLUTION_HANDLE 0x40000000	Un handle de résolution est retourné dans le membre ai_resolutionhandle. Cette option est prise en charge sur Windows 10, Windows Server 2016 et versions ultérieures.
AI_RETURN_TTL 0x0080	Nombre de secondes pendant lesquelles l’enregistrement DNS est valide. Si cet indicateur est présent, la GetAddrInfoEx.paramètre ppResult retourne une liste de structures addrinfoex5, où le membre ai_ttl contiendra la durée de vie individuelle de l’enregistrement DNS.
AI_EXCLUSIVE_CUSTOM_SERVERS 0x0080	Par défaut, les serveurs spécifiés dans le membre ai_servers sont utilisés comme secours aux serveurs DNS système. Si cette option est spécifiée, la requête DNS utilise les serveurs personnalisés spécifiés dans ai_server exclusivement.
AI_RETURN_RESPONSE_FLAGS 0x0080	Demande des informations supplémentaires sur les résultats DNS. Si cet indicateur est présent, le paramètre GetAddrInfoExppResult retourne une liste de structures addrinfoex6, où le membre ai_responseflags contiendra des informations sur l’origine des résultats DNS.

ai_family

Famille d’adresses.

Les valeurs possibles pour la famille d’adresses sont définies dans le fichier d’en-tête Ws2def.h Ws2def.h. Notez que le fichier d’en-tête Ws2def.h est automatiquement inclus dans Winsock2.het ne doit jamais être utilisé directement.

Les valeurs actuellement prises en charge sont AF_INET ou AF_INET6, qui sont les formats de famille d’adresses Internet pour IPv4 et IPv6. D’autres options pour la famille d’adresses (AF_NETBIOS pour une utilisation avec NetBIOS, par exemple) sont prises en charge si un fournisseur de services Windows Sockets pour la famille d’adresses est installé. Notez que les valeurs de la famille d’adresses AF_ et des constantes de famille de protocoles PF_ sont identiques (par exemple, AF_INET et PF_INET), afin que l’une ou l’autre constante puisse être utilisée.

Le tableau ci-dessous répertorie les valeurs courantes pour la famille d’adresses, bien que de nombreuses autres valeurs soient possibles.

Valeur	Signification
AF_UNSPEC 0	La famille d’adresses n’est pas spécifiée.
AF_INET 2	Famille d’adresses IPv4 (Internet Protocol version 4).
AF_NETBIOS 17	Famille d’adresses NetBIOS. Cette famille d’adresses est prise en charge uniquement si un fournisseur Windows Sockets pour NetBIOS est installé.
AF_INET6 23	Famille d’adresses IPv6 (Internet Protocol version 6).
AF_IRDA 26	La famille d’adresses IrDA (Infrarouge Data Association). Cette famille d’adresses est prise en charge uniquement si l’ordinateur dispose d’un port infrarouge et d’un pilote installés.
AF_BTH 32	Famille d’adresses Bluetooth. Cette famille d’adresses est prise en charge uniquement si un adaptateur Bluetooth est installé.

ai_socktype

Type de socket. Les valeurs possibles pour le type de socket sont définies dans le fichier include Winsock2.h.

Le tableau suivant répertorie les valeurs possibles pour le type de socket pris en charge pour Windows Sockets 2 :

Valeur	Signification
SOCK_STREAM 1	Fournit des flux d’octets séquencés, fiables, bidirectionnel et bidirectionnel avec un mécanisme de transmission de données OOB. Utilise le protocole TCP (Transmission Control Protocol) pour la famille d’adresses Internet (AF_INET ou AF_INET6). Si le membre ai_family est AF_IRDA, SOCK_STREAM est le seul type de socket pris en charge.
SOCK_DGRAM 2	Prend en charge les datagrammes, qui sont des mémoires tampons non fiables d’une longueur maximale fixe (généralement petite). Utilise le protocole UDP (User Datagram Protocol) pour la famille d’adresses Internet (AF_INET ou AF_INET6).
SOCK_RAW 3	Fournit un socket brut qui permet à une application de manipuler l’en-tête de protocole de couche supérieure suivante. Pour manipuler l’en-tête IPv4, l’option de socket IP_HDRINCL doit être définie sur le socket. Pour manipuler l’en-tête IPv6, l’option de socket IPV6_HDRINCL doit être définie sur le socket.
SOCK_RDM 4	Fournit un datagramme de message fiable. Un exemple de ce type est l’implémentation de protocole de multidiffusion multidiffusion pragmatique (PGM) dans Windows, souvent appelée programmation de multidiffusion fiable.
SOCK_SEQPACKET 5	Fournit un paquet de pseudo-flux basé sur des datagrammes.

Dans Windows Sockets 2, de nouveaux types de sockets ont été introduits. Une application peut découvrir dynamiquement les attributs de chaque protocole de transport disponible via la fonction WSAEnumProtocols. Ainsi, une application peut déterminer le type de socket et les options de protocole possibles pour une famille d’adresses et utiliser ces informations lors de la spécification de ce paramètre. Les définitions de type de socket dans les fichiers d’en-tête Winsock2.h et Ws2def.h seront régulièrement mises à jour en tant que nouveaux types de sockets, familles d’adresses et protocoles définis.

Dans Windows Sockets 1.1, les seuls types de sockets possibles sont SOCK_DATAGRAM et SOCK_STREAM.

ai_protocol

Type de protocole. Les options possibles sont spécifiques à la famille d’adresses et au type de socket spécifiés. Les valeurs possibles pour l'ai_protocol sont définies dans winsock2.h et les fichiers d’en-tête Wsrm.h.

Sur le Kit de développement logiciel (SDK) Windows publié pour Windows Vista et ultérieur, l’organisation des fichiers d’en-tête a changé et ce membre peut être l’une des valeurs du type d’énumération IPPROTO défini dans le fichier d’en-tête Ws2def.h . Notez que le fichier d’en-tête Ws2def.h est automatiquement inclus dans Winsock2.het ne doit jamais être utilisé directement.

Si la valeur 0 est spécifiée pour ai_protocol, l’appelant ne souhaite pas spécifier de protocole et le fournisseur de services choisit l'ai_protocol à utiliser. Pour les protocoles autres que IPv4 et IPv6, définissez ai_protocol sur zéro.

Le tableau suivant répertorie les valeurs courantes pour le membre ai_protocol bien que de nombreuses autres valeurs soient possibles.

Valeur	Signification
IPPROTO_TCP 6	Protocole TCP (Transmission Control Protocol). Il s’agit d’une valeur possible lorsque le membre ai_family est AF_INET ou AF_INET6 et que le membre ai_socktype est SOCK_STREAM.
IPPROTO_UDP 17	Protocole UDP (User Datagram Protocol). Il s’agit d’une valeur possible lorsque le membre ai_family est AF_INET ou AF_INET6 et que le paramètre de type est SOCK_DGRAM.
IPPROTO_RM 113	Protocole PGM pour la multidiffusion fiable. Il s’agit d’une valeur possible lorsque le membre ai_family est AF_INET et que le membre ai_socktype est SOCK_RDM. Sur le Kit de développement logiciel (SDK) Windows publié pour Windows Vista et versions ultérieures, cette valeur est également appelée IPPROTO_PGM.

Si le membre ai_family est AF_IRDA, la ai_protocol doit être 0.

ai_addrlen

Longueur, en octets, de la mémoire tampon pointée par le membre ai_addr.

ai_canonname

Nom canonique de l’hôte.

ai_addr

Pointeur vers une structure sockaddr . Le membre ai_addr dans chaque addrinfoex4 retourné pointe vers une structure d’adresse de socket renseignée. La longueur, en octets, de chaque structure addrinfoex4 retournée est spécifiée dans le membre ai_addrlen.

ai_blob

Pointeur vers des données utilisées pour retourner des informations d’espace de noms spécifiques au fournisseur associées au nom au-delà d’une liste d’adresses. La longueur, en octets, de la mémoire tampon pointée par ai_blob doit être spécifiée dans le membre ai_bloblen.

ai_bloblen

Longueur, en octets, du membre ai_blob.

ai_provider

Pointeur vers le GUID d’un fournisseur d’espaces de noms spécifique.

ai_next

Pointeur vers la structure suivante dans une liste liée. Ce paramètre est défini sur NULL dans la dernière structure addrinfoex4 d’une liste liée.

ai_version

Numéro de version de cette structure. La valeur actuellement utilisée pour cette version de la structure est 4.

ai_fqdn

Nom de domaine complet de l’hôte.

ai_interfaceindex

Index d’interface, tel que défini par le IP_ADAPTER_ADDRESSES.propriété IfIndex retournée dans GetAdaptersAddresses.

ai_resolutionhandle

Gérer le pointage vers le nom de domaine complet de l’hôte.

ai_ttl

Nombre de secondes pendant lesquelles cet enregistrement DNS est valide.

ai_numservers

Nombre de serveurs DNS personnalisés présents dans le membre ai_servers.

ai_servers

Tableau de N (où N == ai_numservers) ADDRINFO_DNS_SERVER objets. Si ai_numservers est 0, ai_servers doit être NULL .

ai_responseflags

Retourne une bitmap contenant l’une des valeurs suivantes.

Constant	Valeur	Signification
AI_DNS_RESPONSE_SECURE	0x1	La réponse provient de protocoles sécurisés, tels que DNS-over-HTTPS.
AI_DNS_RESPONSE_HOSTFILE	0x2	La réponse provient des hôtes fichier.

Remarques

La structure ADDRINFOEX6 est une extension de la structure ADDRINFOEX5. Outre tous les champs de la structure ADDRINFOEX5, il contient les membres ai_numservers et ai_servers, ce qui permet d’utiliser des serveurs DNS personnalisés par requête. Il contient également le membre ai_responseflags, qui contient des informations sur l’origine des réponses DNS.

Si l’indicateur AI_RETURN_RESPONSE_FLAGS est présent dans le membre ai_flags, le paramètre GetAddrInfoExppResult retourne une liste de structures ADDRINFOEX6, où le membre ai_responseflags contiendra des informations sur l’origine des résultats DNS.

Si les membres ai_numservers et ai_servers pointent vers un tableau d’objets ADDRINFO_DNS_SERVER valides, la requête DNS ajoute ces serveurs comme secours aux serveurs DNS configurés par le système. Si l’option AI_EXCLUSIVE_CUSTOM_SERVERS est présente dans le membre ai_flags, la requête DNS utilise exclusivement les serveurs personnalisés.