DNS_DOH_SERVER_SETTINGS-Struktur (netioapi.h)

Beschreibt einen DNS-over-HTTPS-Server.

Syntax

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

Member

Template

Typ: PWSTR

Eine mit NULL beendete breite Zeichenfolge, die eine gültige DNS-over-HTTPS-URI-Vorlage enthält.

Dieses Feld muss NULL sein, wenn das flag DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO vorhanden ist.

Wichtig

Die URI-Vorlage darf keine IP-Adresse als Hostname enthalten, die sich von der IP-Adresse des Servers unterscheidet, auf den verwiesen wird. Wenn beispielsweise der Server, auf den verwiesen wird, 1.1.1.1 lautet und die URI-Vorlage https://1.0.0.1/dns-querylautet, ist dies ungültig, da 1.0.0.1 nicht mit der Server-IP 1.1.1.1 übereinstimmt.

Flags

Typ: ULONG64

Eine Bitmap, die eine der folgenden Optionen enthält.

DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO (0x0001). Wenn diese Option vorhanden ist, lädt der DNS-Server, auf den von dieser Eigenschaft verwiesen wird, seine URI-Vorlage aus der Systemliste DNS-over-HTTPS. Wenn diese Option vorhanden ist, muss das Feld Vorlage auf NULL festgelegt werden. Diese Option darf nicht zusammen mit der Option DNS_DOH_SERVER_SETTINGS_ENABLE verwendet werden.

DNS_DOH_SERVER_SETTINGS_ENABLE (0x0002). Wenn diese Option vorhanden ist, muss das Feld Vorlage auf eine gültige DNS-over-HTTPS-URI-Vorlage verweisen. Diese Option darf nicht zusammen mit der Option DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO verwendet werden.

DNS_DOH_SERVER_SETTINGS_FALLBACK_TO_UDP (0x0004). Diese Option gibt an, dass der Server, auf den verwiesen wird, möglicherweise ein Fallback auf die unsichere Namensauflösung (UDP/TCP) erfolgt, wenn bei der DNS-over-HTTPS-Abfrage ein Fehler aufgetreten ist. Diese Option kann nur zusätzlich zu DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO oder DNS_DOH_SERVER_SETTINGS_ENABLE verwendet werden.

DNS_DOH_AUTO_UPGRADE_SERVER (0x0008). Diese Option ermöglicht es einem DNS-Server, der in einer NRPT-Regel vorhanden ist, die DNS-over-HTTPS-Vorlage zu verwenden, wenn sie über dieselbe IP-Adresse wie der Server verfügt, auf den von dieser Eigenschaft verwiesen wird. Diese Option kann nicht selbst verwendet werden. sie muss zusätzlich zu DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO oder DNS_DOH_SERVER_SETTINGS_ENABLE sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	netioapi.h (include Iphlpapi.h)