Méthode EnableDNS de la classe Win32_NetworkAdapterConfiguration
La méthode statique de classe WMIEnableDNS active le système DNS (Domain Name System) pour le service.
Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.
Syntaxe
uint32 EnableDNS(
[in, optional] string DNSHostName,
[in, optional] string DNSDomain,
[in, optional] string DNSServerSearchOrder[],
[in, optional] string DNSDomainSuffixSearchOrder[]
);
Paramètres
-
DNSHostName [in, facultatif]
-
Nom de l’hôte DNS activé par cette méthode.
Exemple : « corpdns »
-
DNSDomain [in, facultatif]
-
Représente un nom organization suivi d’un point et d’une extension qui indique le type de organization.
Exemple : « microsoft.com »
-
DNSServerSearchOrder [in, facultatif]
-
Liste des adresses IP de serveur à interroger pour les serveurs DNS.
-
DNSDomainSuffixSearchOrder [in, facultatif]
-
Suffixe de domaine DNS ajouté à un nom d’hôte lors de la résolution de noms. Lors de la résolution d’un nom de domaine complet (FQDN) à partir d’un nom d’hôte uniquement, le système ajoute le nom de domaine local. Si la résolution de noms ne réussit pas, le système utilise la liste de suffixes de domaine pour créer des noms de domaine complets supplémentaires dans l’ordre indiqué, puis interroge les serveurs DNS pour chacun d’eux.
Valeur retournée
Retourne la valeur 0 (zéro) pour une exécution réussie lorsqu’un redémarrage n’est pas requis, 1 (un) pour une exécution réussie lorsqu’un redémarrage est requis et tout autre nombre en cas d’erreur. Pour plus d’informations sur les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.
-
Achèvement réussi, aucun redémarrage requis
-
0
Réussite de l’exécution, aucun redémarrage n’est requis.
-
Achèvement réussi, redémarrage requis
-
1
Réussite de l’exécution, redémarrage requis.
-
Méthode non prise en charge sur cette plateforme
-
64
Méthode non prise en charge sur cette plateforme.
-
Échec inconnu
-
65
Échec inconnu.
-
Masque de sous-réseau non valide
-
66
Masque de sous-réseau non valide.
-
Une erreur s’est produite lors du traitement d’une instance retournée
-
67
Une erreur s’est produite lors du traitement d’un instance retourné.
-
Paramètre d’entrée non valide
-
68
Paramètre d'entrée non valide.
-
Plus de 5 passerelles spécifiées
-
69
Plus de cinq passerelles spécifiées.
-
Adresse IP non valide
-
70
Adresse IP non valide.
-
Adresse IP de la passerelle non valide
-
71
Adresse IP de la passerelle non valide.
-
Une erreur s’est produite lors de l’accès au Registre pour les informations demandées
-
72
Une erreur s’est produite lors de l’accès au Registre pour les informations demandées.
-
Nom de domaine non valide
-
73
Nom de domaine non valide.
-
Nom d’hôte non valide
-
74
Nom d’hôte non valide.
-
Aucun serveur WINS principal/secondaire défini
-
75
Aucun serveur WINS principal ou secondaire défini.
-
Fichier non valide
-
76
Fichier non valide.
-
Chemin d’accès système non valide
-
77
Chemin d’accès système non valide.
-
Échec de la copie de fichier
-
78
Échec de la copie de fichier.
-
Paramètre de sécurité non valide
-
79
Paramètre de sécurité non valide.
-
Impossible de configurer le service TCP/IP
-
80
Impossible de configurer le service TCP/IP.
-
Impossible de configurer le service DHCP
-
81
Impossible de configurer le service DHCP.
-
Impossible de renouveler le bail DHCP
-
82
Impossible de renouveler le bail DHCP.
-
Impossible de libérer le bail DHCP
-
83
Impossible de libérer le bail DHCP.
-
ADRESSE IP non activée sur l’adaptateur
-
84
IP non activée sur l’adaptateur.
-
IPX non activé sur l’adaptateur
-
85 %
IPX non activé sur l’adaptateur.
-
Erreur de limites de numéro de trame/réseau
-
86
Erreur de limites de trame ou de numéro de réseau.
-
Type de frame non valide
-
87
Type de frame non valide.
-
Numéro de réseau non valide
-
88
Numéro de réseau non valide.
-
Numéro de réseau en double
-
89
Numéro de réseau en double.
-
Paramètre hors limites
-
90
Paramètre hors limites.
-
Accès refusé
-
91
Accès refusé.
-
Mémoire insuffisante
-
92
Mémoire insuffisante.
-
Existe déjà
-
93
Existe déjà.
-
Chemin d’accès, fichier ou objet introuvable
-
94
Chemin, fichier ou objet introuvable.
-
Impossible de notifier le service
-
95
Impossible de notifier le service.
-
Impossible de notifier le service DNS
-
96
Impossible de notifier le service DNS.
-
Interface non configurable
-
97
Interface non configurable.
-
Tous les baux DHCP n’ont pas pu être libérés/renouvelés
-
98
Tous les baux DHCP ne peuvent pas être libérés ou renouvelés.
-
DHCP non activé sur l’adaptateur
-
100
DHCP non activé sur l’adaptateur.
-
Autres
-
101 4294967295
Exemples
L’exemple de code suivant, extrait de l’exemple de code VBScript Activer DNS sur toutes les cartes réseau sur TechNet Gallery, active DNS pour toutes les cartes réseau sur un ordinateur.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration")
strHostName = "fabrikam1"
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com")
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|