DNS_INTERFACE_SETTINGS-Struktur (netioapi.h)
Stellt die DNS-Einstellungen dar, die auf einer bestimmten Schnittstelle durch Aufrufen der SetInterfaceDnsSettings-Funktion konfiguriert oder für eine bestimmte Schnittstelle durch Aufrufen der GetInterfaceDnsSettings-Funktion abgerufen werden können.
Syntax
typedef struct _DNS_INTERFACE_SETTINGS {
ULONG Version;
ULONG64 Flags;
PWSTR Domain;
PWSTR NameServer;
PWSTR SearchList;
ULONG RegistrationEnabled;
ULONG RegisterAdapterName;
ULONG EnableLLMNR;
ULONG QueryAdapterName;
PWSTR ProfileNameServer;
} DNS_INTERFACE_SETTINGS;
Member
Version
Typ: ULONG
Muss auf DNS_INTERFACE_SETTINGS_VERSION1 festgelegt werden.
Flags
Typ: ULONG64
Eine Bitmap der folgenden Optionen.
DNS_SETTING_IPV6 (0x0001). Konfiguriert die Schnittstelleneinstellungen nur für den IPv6-Netzwerkstapel. Wenn diese Option festgelegt ist, müssen alle IP-Adressen, die in den Membern NameServer oder ProfileNameServer angegeben sind, IPv6-Adressen sein. Standardmäßig werden die in dieser Struktur angegebenen DNS-Schnittstelleneinstellungen nur auf den IPv4-Netzwerkstapel angewendet.
DNS_SETTING_NAMESERVER (0x0002). Konfiguriert die DNS-Server des statischen Adapters auf der angegebenen Schnittstelle über den NameServer-Member .
DNS_SETTING_SEARCHLIST (0x0004). Konfiguriert die verbindungsspezifische DNS-Suffixsuchliste für den angegebenen Adapter über das SearchList-Element .
DNS_SETTING_REGISTRATION_ENABLED (0x0008). Aktiviert oder deaktiviert die dynamische DNS-Registrierung für den angegebenen Adapter. Dies ist standardmäßig systemfähig.
DNS_SETTING_DOMAIN (0x0020). Konfiguriert das verbindungsspezifische DNS-Suffix für den angegebenen Adapter über das Domänenmitglied .
DNS_SETTINGS_ENABLE_LLMNR (0x0080). Aktiviert oder deaktiviert die Namensauflösung mithilfe von LLMNR und mDNS auf dem angegebenen Adapter. Dies ist standardmäßig systemfähig.
DNS_SETTINGS_QUERY_ADAPTER_NAME (0x0100). Aktiviert oder deaktiviert die Verwendung des Adapternamens als Suffix für DNS-Abfragen. Dies ist standardmäßig systemfähig.
DNS_SETTING_PROFILE_NAMESERVER (0x0200). Konfiguriert statische DNS-Profilserver auf der angegebenen Schnittstelle über das ProfileNameServer-Element .
Domain
Typ: PWSTR
Eine mit NULL beendete breite Zeichenfolge, die den Domänennamen des Adapters enthält.
NameServer
Typ: PWSTR
Eine mit NULL endende breite Zeichenfolge, die eine Reihe von durch Kommas oder leerzeichentrennten DNS-Servern enthält. Beispiel: L"1.1.1.1 8.8.8.8" oder L"1.1.1.1,8.8.8.8".
Wenn das flag DNS_SETTING_IPV6 vorhanden ist, müssen die Server IPv6-Adressen sein. Beispiel: L"2606:4700:4700::1001,2606:4700:4700::1111".
SearchList
Typ: PWSTR
Eine mit NULL endende breite Zeichenfolge, die eine Reihe von durch Kommas oder Leerzeichen getrennten Suchnamen enthält. Beispiel: L"contoso1.com contoso2.com", oder L"contoso1.com, contoso2.com".
RegistrationEnabled
Typ: ULONG
TRUE , um die dynamische Registrierung des Adapters zu aktivieren; FALSE , um es zu deaktivieren.
RegisterAdapterName
Typ: ULONG
TRUE , um die Registrierung des Adapternamens zu aktivieren; FALSE , um es zu deaktivieren.
EnableLLMNR
Typ: ULONG
TRUE , um mDNS und LLMNR auf der angegebenen Schnittstelle zu aktivieren; FALSE , um sie zu deaktivieren.
QueryAdapterName
Typ: ULONG
TRUE , wenn der Adaptername als Suchsuffix verwendet werden soll; andernfalls FALSE.
ProfileNameServer
Typ: PWSTR
Eine mit NULL endende breite Zeichenfolge, die eine Reihe von durch Kommas oder leerzeichentrennten DNS-Servern enthält. Beispiel: L"1.1.1.1 8.8.8.8" oder L"1.1.1.1,8.8.8.8".
Wenn das flag DNS_SETTING_IPV6 vorhanden ist, müssen die Server IPv6-Adressen sein. Beispiel: L"2606:4700:4700::1001,2606:4700:4700::1111".
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 Build 18362 |
| Unterstützte Mindestversion (Server) | Windows 10 Build 18362 |
| Kopfzeile | netioapi.h (include Iphlpapi.h) |