structure DNS_INTERFACE_SETTINGS (netioapi.h)
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) |