structure ADDRINFO_DNS_SERVER (ws2def.h)

Article
03/13/2024

Représente un serveur DNS (Domain Name System) personnalisé, utilisé dans les API Winsock.

Syntaxe

typedef struct addrinfo_dns_server {
  unsigned int     ai_servertype;
  unsigned __int64 ai_flags;
  unsigned int     ai_addrlen;
  struct sockaddr  *ai_addr;
  union {
    PWSTR ai_template;
  };
} ADDRINFO_DNS_SERVER;

Membres

ai_servertype

Type de serveur DNS. Il peut s’agir de l’une des valeurs suivantes.

Constant	Valeur	Signification
AI_DNS_SERVER_TYPE_UDP	1	Un serveur DNS standard.
AI_DNS_SERVER_TYPE_DOH	2	Un serveur DNS-over-HTTPS .

ai_flags

Bitmap contenant l’une des options suivantes.

Constant	Valeur	Signification
AI_DNS_SERVER_UDP_FALLBACK	0x1	Ce serveur peut également être utilisé pour la résolution de noms non sécurisée.

ai_addrlen

Longueur en octets de la structure d’adresse de socket vers laquelle pointe ai_addr .

ai_addr

Pointeur vers une structure d’adresse de socket contenant l’adresse du serveur personnalisé. Seules les structures SOCKADDR_IN et SOCKADDR_IN6 sont prises en charge. Le membre sa_family doit être défini sur AF_INET ou AF_INET6. Le reste de la structure doit être supprimé, à l’exception du membre SOCKADDR_IN ::sin_addr pour IPv4 ou SOCKADDR_IN6 ::sin6_addr pour IPv6.

ai_template

Si ai_servertype est défini sur AI_DNS_SERVER_TYPE_DOH, ce membre doit pointer vers une chaîne large terminée par NULL représentant le modèle DNS-over-HTTPS pour ce serveur.

Si ai_servertype a la valeur AI_DNS_SERVER_TYPE_UDP, ce champ doit avoir la valeur NULL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Build 22000
Serveur minimal pris en charge	Windows Build 22000
En-tête	ws2def.h

Voir aussi

ADDRINFOEX6

Partager via