DNS_DOH_SERVER_SETTINGS structure (netioapi.h)

Décrit un serveur DNS-over-HTTPS.

Syntaxe

typedef struct _DNS_DOH_SERVER_SETTINGS {
#if ...
  PWSTR   Template;
#else
  PWSTR   Template;
#endif
  ULONG64 Flags;
} DNS_DOH_SERVER_SETTINGS;

Membres

Template

Type : PWSTR

Chaîne large terminée par NULL contenant un modèle d’URI DNS-over-HTTPS valide.

Ce champ doit être NULL si l’indicateur DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO est présent.

Important

Le modèle d’URI ne doit pas contenir d’adresse IP en tant que nom d’hôte différent de l’adresse IP du serveur référencé. Par exemple, si le serveur référencé est 1.1.1.1 et que le modèle d’URI est https://1.0.0.1/dns-query, cela ne serait pas valide, car 1.0.0.1 ne correspond pas à l’adresse IP du serveur 1.1.1.1.1.

Flags

Type : ULONG64

Bitmap contenant l’une des options suivantes.

DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO (0x0001). Si cette option est présente, le serveur DNS référencé par cette propriété charge son modèle d’URI à partir de la liste système DNS-over-HTTPS. Lorsque cette option est présente, le champ Modèle doit être défini sur NULL. Cette option ne doit pas être utilisée avec l’option DNS_DOH_SERVER_SETTINGS_ENABLE .

DNS_DOH_SERVER_SETTINGS_ENABLE (0x0002). Si cette option est présente, le champ Modèle doit pointer vers un modèle d’URI DNS-over-HTTPS valide. Cette option ne doit pas être utilisée avec l’option DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO .

DNS_DOH_SERVER_SETTINGS_FALLBACK_TO_UDP (0x0004). Cette option indique que le serveur référencé peut revenir à la résolution de noms non sécurisée (UDP/TCP) si la requête DNS-over-HTTPS a échoué. Cette option ne peut être utilisée qu’en plus des DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO ou DNS_DOH_SERVER_SETTINGS_ENABLE.

DNS_DOH_AUTO_UPGRADE_SERVER (0x0008). Cette option permet à un serveur DNS présent dans une règle NRPT d’utiliser le modèle DNS-over-HTTPS s’il a la même adresse IP que le serveur référencé par cette propriété. Cette option ne peut pas être utilisée seule ; il doit s’ajouter à DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO ou DNS_DOH_SERVER_SETTINGS_ENABLE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	netioapi.h (include Iphlpapi.h)