Méthode SetDNSServerSearchOrder de la classe Win32_NetworkAdapterConfiguration
La méthode de classe WMISetDNSServerSearchOrder utilise un tableau d’éléments de chaîne pour définir l’ordre de recherche sur le serveur.
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 SetDNSServerSearchOrder(
[in] string DNSServerSearchOrder[]
);
Paramètres
-
DNSServerSearchOrder [in]
-
Liste des adresses IP de serveur à interroger pour les serveurs DNS.
Exemple : 130.215.24.1 ou 157.54.164.1
Valeur retournée
Retourne une valeur de 0 (zéro) pour une exécution réussie lorsqu’aucun redémarrage n’est requis, 1 (un) pour une exécution réussie lorsqu’un redémarrage est requis et un nombre différent 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)
-
Achèvement réussi, redémarrage requis (1)
-
Méthode non prise en charge sur cette plateforme (64)
-
Échec inconnu (65)
-
Masque de sous-réseau non valide (66)
-
Une erreur s’est produite lors du traitement d’une instance retournée (67)
-
Paramètre d’entrée non valide (68)
-
Plus de 5 passerelles spécifiées (69)
-
Adresse IP non valide (70)
-
Adresse IP de la passerelle non valide (71)
-
Une erreur s’est produite lors de l’accès au Registre pour les informations demandées (72)
-
Nom de domaine non valide (73)
-
Nom d’hôte non valide (74)
-
Aucun serveur WINS principal/secondaire défini (75)
-
Fichier non valide (76)
-
Chemin d’accès système non valide (77)
-
Échec de la copie de fichiers (78)
-
Paramètre de sécurité non valide (79)
-
Impossible de configurer le service TCP/IP (80)
-
Impossible de configurer le service DHCP (81)
-
Impossible de renouveler le bail DHCP (82)
-
Impossible de libérer le bail DHCP (83)
-
IP non activée sur l’adaptateur (84)
-
IPX non activé sur l’adaptateur (85)
-
Erreur de limites de numéro de trame/réseau (86)
-
Type de frame non valide (87)
-
Numéro de réseau non valide (88)
-
Numéro réseau en double (89)
-
Paramètre hors limites (90)
-
Accès refusé (91)
-
Mémoire insuffisante (92)
-
Existe déjà (93)
-
Chemin d’accès, fichier ou objet introuvable (94)
-
Impossible de notifier le service (95)
-
Impossible de notifier le service DNS (96)
-
Interface non configurable (97)
-
Tous les baux DHCP n’ont pas pu être libérés/renouvelés (98)
-
DHCP non activé sur l’adaptateur (100)
-
Autres (101 4294967295)
Notes
Il s’agit d’un appel de méthode dépendant instance qui s’applique par adaptateur. Une fois que les serveurs DNS statiques sont spécifiés pour commencer à utiliser le protocole DHCP (Dynamic Host Configuration Protocol) au lieu de serveurs DNS statiques, vous pouvez appeler la méthode sans fournir de paramètres « in ».
Exemples
L’exemple SET DNS Server Search Order for Multiple Computers in an Organizational Unit VBScript sur TechNet Gallery récupère ou définit l’ordre de recherche du serveur DNS pour plusieurs ordinateurs appartenant à une unité d’organisation.
L’exemple Modifier l’ordre de recherche du serveur DNS pour une carte réseau VBScript configure une carte réseau tcp/IP pour utiliser deux serveurs DNS.
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 |
|