Méthode SetWINSServer de la _ classe Win32 NetworkAdapterConfiguration
la méthode de classe WMI SetWINSServer définit les serveurs WINS (primary et secondary Windows Internet Service de nommage) sur cette carte réseau TCP/IP. Cette méthode est appliquée indépendamment de la carte réseau.
Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.
Syntaxe
uint32 SetWINSServer(
[in] string WINSPrimaryServer,
[in] string WINSSecondaryServer
);
Paramètres
-
WINSPrimaryServer [ dans]
-
Adresse IP du serveur WINS principal.
Notes
Vérifiez toujours la validité de cette adresse IP lorsqu’elle provient d’une source inconnue ou d’une source qui n’est pas digne de confiance.
-
WINSSecondaryServer [ dans]
-
Adresse IP du serveur WINS secondaire.
Notes
Vérifiez toujours la validité de cette adresse IP lorsqu’elle provient d’une source inconnue ou d’une source qui n’est pas digne de confiance.
Valeur retournée
Retourne une valeur entière égale à 0 (zéro) en cas de réussite de l’opération, ainsi que tout autre nombre pour indiquer une erreur. Pour plus d’informations sur les codes d’erreur, consultez constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir les valeurs de HRESULT générales, consultez codes d’erreur système.
-
Exécution réussie, aucun redémarrage requis
-
0
Opération réussie, aucun redémarrage n’est nécessaire.
-
Achèvement réussi, redémarrage requis
-
1
Opération terminée, 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 qui a été retournée
-
67
Une erreur s’est produite lors du traitement d’une instance qui a été retournée.
-
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 sont spécifiées.
-
Adresse IP non valide
-
70
Adresse IP non valide.
-
Adresse IP de passerelle non valide
-
71
Adresse IP de 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 n’est défini.
-
Fichier non valide
-
76
Fichier non valide.
-
Chemin système non valide
-
77
Chemin d’accès système non valide.
-
Échec de la copie du fichier
-
78
Échec de la copie du 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.
-
IP non activé sur l’adaptateur
-
84
IP non activé sur l’adaptateur.
-
IPX non activé sur l’adaptateur
-
85 %
IPX n’est pas activé sur l’adaptateur.
-
Erreur liée à un nombre de trames/réseau
-
86
Erreur liée à l’image ou au numéro de réseau.
-
Type de trame non valide
-
87
Type de trame 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 d’accès, fichier ou objet introuvable.
-
Impossible de notifier le service
-
95
Impossible de notifier le service.
-
Impossible d’informer le service DNS
-
96
Impossible d’informer 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 n’ont pas pu être libérés ou renouvelés.
-
DHCP n’est pas activé sur l’adaptateur
-
100
DHCP n’est pas activé sur l’adaptateur.
-
Autres
-
101 4294967295
Remarques
Si WINSPrimaryServer et WINSSecondaryServer sont tous les deux définis sur «» (une chaîne vide), les serveurs WINS explicites reviennent à DHCP.
Exemples
L’affectation d’une adresse IP extraite d’une base de données L’exemple de code VBScript recherche un ordinateur dans une base de données et lui attribue l’adresse IP spécifiée.
L’exemple de code VBScript suivant définit le serveur WINS principal et secondaire pour une carte réseau TCP/IP.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colNetCards = objWMIService.ExecQuery _
("Select * From Win32_NetworkAdapterConfiguration Where IPEnabled = True")
For Each objNetCard in colNetCards
strPrimaryServer = "192.168.1.100"
strSecondaryServer = "192.168.1.200"
objNetCard.SetWINSServer strPrimaryServer, strSecondaryServer
Next
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
\Cimv2 racine |
| MOF |
|
| DLL |
|