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

Voir aussi

Classes matérielles du système informatique

_NetworkAdapterConfiguration Win32

Tâches WMI : mise en réseau

Tâches WMI : comptes et domaines

Prise en charge D’ipv6 et IPv6 dans WMI