Méthode SetDNSServerSearchOrder de la classe Win32_NetworkAdapterConfiguration

La méthode de classe SetDNSServerSearchOrderWMI utilise un tableau d’éléments de chaîne pour définir l’ordre de recherche du 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 du 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 fin réussie lorsqu’un redémarrage est requis et un nombre différent s’il y a une erreur. Pour plus d’informations sur les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir des valeurs HRESULT générales, consultez Codes d’erreur système.

Réussite de l’exécution, 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 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 fichier (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)

ADRESSE IP non activée sur l’adaptateur (84)

IPX non activé sur l’adaptateur (85)

Erreur liée au nombre de trames/réseau (86)

Type d’image non valide (87)

Numéro de réseau non valide (88)

Numéro de réseau en double (89)

Paramètre hors limites (90)

Accès refusé (91)

Mémoire hors mémoire (92)

Existe déjà (93)

Chemin d’accès, fichier ou objet introuvable (94)

Impossible de notifier le service (95)

Impossible d’avertir le service DNS (96)

Interface non configurable (97)

Tous les baux DHCP ne peuvent pas ê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 de l’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’ordre de recherche du serveur DNS pour plusieurs ordinateurs dans un exemple VBScript d’unité organisationnelle sur TechNet Gallery récupère ou définit l’ordre de recherche du serveur DNS pour plusieurs ordinateurs appartenant à une unité organisationnelle.

L’exemple Modifier l’ordre de recherche du serveur DNS pour un exemple VBScript de carte réseau configure une carte réseau liée à TCP/IP pour utiliser deux serveurs DNS.

Configuration requise

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 iPv6 et IPv4 dans WMI