Partager via


structure DNS_CUSTOM_SERVER (windns.h)

Représente un serveur personnalisé DNS. Un objet DNS_CUSTOM_SERVER est passé à dnsQueryEx via la structure DNS_QUERY_REQUEST3.

Pour utiliser DNS_CUSTOM_SERVER avecServerAddr , incluez avant .

Syntaxe

typedef struct _DNS_CUSTOM_SERVER {
  DWORD   dwServerType;
  ULONG64 ullFlags;
  union {
    PWSTR pwszTemplate;
    PWSTR pwszHostname;
  };
  CHAR    MaxSa[DNS_ADDR_MAX_SOCKADDR_LENGTH];
} DNS_CUSTOM_SERVER;

Membres

dwServerType

Type : DWORD

Type de serveur. Doit être l’un des éléments suivants.

Valeur Description
DNS_CUSTOM_SERVER_TYPE_UDP 0x1 Effectuer une résolution de noms non sécurisée
DNS_CUSTOM_SERVER_TYPE_DOH 0x2 Effectuer résolution de noms DNS-over-HTTPS

ullFlags

Type : ULONG64

Valeur qui contient une bitmap des options suivantes.

Valeur Description
DNS_CUSTOM_SERVER_UDP_FALLBACK 0x1 Le serveur peut revenir à une résolution non sécurisée

pwszTemplate

Type : PWSTR

Chaîne large NULL-terminated représentant le modèle DNS-over-HTTPS.

Si dwServerType est défini sur DNS_CUSTOM_SERVER_TYPE_UDP, ce champ doit être NULL .

Si dwServerType est défini sur DNS_CUSTOM_SERVER_TYPE_DOH, ce champ doit pointer vers une chaîne null valide-terminated string.

pwszHostname

MaxSa[DNS_ADDR_MAX_SOCKADDR_LENGTH]

Type : CHAR [DNS_ADDR_MAX_SOCKADDR_LENGTH]

Tableau d’octets, qui désigne le stockage d’un SOCKADDR_INET. MaxSa est une union avec ServerAddr.

Pour utiliser DNS_CUSTOM_SERVER avecServerAddr , vous devez inclure avant .

Outre le stockage de la SOCKADDR_INET, MaxSa évite les erreurs de compilation provoquées par pas y compris ws2ipdef.h. Cela vous permet d’utiliser n’importe quelle fonctionnalité de windns.h à l’exception de la DNS_CUSTOM_SERVER.

Exigences

Exigence Valeur
client minimum pris en charge Windows Build 22000
serveur minimum pris en charge Windows Build 22000
d’en-tête windns.h

Voir aussi