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	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes matérielles du système informatique

Win32_NetworkAdapterConfiguration

Tâches WMI : Mise en réseau

Tâches WMI : Comptes et domaines

Prise en charge d’IPv6 et IPv4 dans WMI