structure DNS_INTERFACE_SETTINGS (netioapi.h)

  • Article

Représente les paramètres DNS qui peuvent être configurés sur une interface donnée en appelant la fonction SetInterfaceDnsSettings ou récupérés pour une interface donnée en appelant la fonction GetInterfaceDnsSettings .

Syntaxe

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;

Membres

Version

Type : ULONG

Doit être défini sur DNS_INTERFACE_SETTINGS_VERSION1.

Flags

Type : ULONG64

Bitmap des options suivantes.

DNS_SETTING_IPV6 (0x0001). Configure les paramètres d’interface uniquement pour la pile réseau IPv6. Si cette option est définie, toutes les adresses IP spécifiées dans les membres NameServer ou ProfileNameServer doivent être des adresses IPv6. Par défaut, les paramètres d’interface DNS spécifiés dans cette structure sont appliqués uniquement à la pile réseau IPv4.

DNS_SETTING_NAMESERVER (0x0002). Configure des serveurs DNS d’adaptateur statique sur l’interface spécifiée via le membre NameServer .

DNS_SETTING_SEARCHLIST (0x0004). Configure la liste de recherche de suffixes DNS spécifiques à la connexion pour l’adaptateur donné via le membre SearchList .

DNS_SETTING_REGISTRATION_ENABLED (0x0008). Active ou désactive l’inscription DNS dynamique pour l’adaptateur donné. Cette option est activée par défaut pour le système.

DNS_SETTING_DOMAIN (0x0020). Configure le suffixe DNS spécifique à la connexion pour l’adaptateur donné via le membre Domain .

DNS_SETTINGS_ENABLE_LLMNR (0x0080). Active ou désactive la résolution de noms à l’aide de LLMNR et mDNS sur l’adaptateur spécifié. Cette option est activée par défaut pour le système.

DNS_SETTINGS_QUERY_ADAPTER_NAME (0x0100). Active ou désactive l’utilisation du nom de l’adaptateur comme suffixe pour les requêtes DNS. Cette option est activée par défaut pour le système.

DNS_SETTING_PROFILE_NAMESERVER (0x0200). Configure les serveurs DNS de profil statique sur l’interface spécifiée via le membre ProfileNameServer .

Domain

Type : PWSTR

Chaîne large terminée par NULL contenant le nom de domaine de l’adaptateur.

NameServer

Type : PWSTR

Chaîne large terminée par NULL contenant une série de serveurs DNS séparés par des virgules ou des espaces. Par exemple, L"1.1.1.1 8.8.8 », ou L"1.1.1.1.1,8.8.8.8 ».

Si l’indicateur DNS_SETTING_IPV6 est présent, les serveurs doivent être des adresses IPv6. Par exemple, L"2606 :4700 :4700 ::1001,2606 :4700 :4700 ::1111 ».

SearchList

Type : PWSTR

Chaîne large terminée par NULL contenant une série de noms de recherche séparés par des virgules ou des espaces. Par exemple, L"contoso1.com contoso2.com », ou L"contoso1.com, contoso2.com ».

RegistrationEnabled

Type : ULONG

TRUE pour activer l’inscription dynamique de l’adaptateur ; FALSE pour le désactiver.

RegisterAdapterName

Type : ULONG

TRUE pour activer l’inscription du nom de l’adaptateur ; FALSE pour le désactiver.

EnableLLMNR

Type : ULONG

TRUE pour activer mDNS et LLMNR sur l’interface donnée ; FALSE pour les désactiver.

QueryAdapterName

Type : ULONG

TRUE si le nom de l’adaptateur doit être utilisé comme suffixe de recherche ; sinon , FALSE.

ProfileNameServer

Type : PWSTR

Chaîne large terminée par NULL contenant une série de serveurs DNS séparés par des virgules ou des espaces. Par exemple, L"1.1.1.1 8.8.8 » ou L"1.1.1.1.1,8.8.8.8 ».

Si l’indicateur DNS_SETTING_IPV6 est présent, les serveurs doivent être des adresses IPv6. Par exemple, L"2606 :4700 :4700 ::1001,2606 :4700 :4700 ::1111 ».

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 Build 18362
Serveur minimal pris en charge Windows 10 Build 18362
En-tête netioapi.h (inclure Iphlpapi.h)

Voir aussi