DNS_INTERFACE_SETTINGS-Struktur (netioapi.h)

  • Artikel

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)

Weitere Informationen