SetWINSServer-Methode der Win32_NetworkAdapterConfiguration-Klasse
Die WMI-KlassenmethodeSetWINSServer legt die primären und sekundären WINDOWS-WINS-Server (Internet Naming Service) auf diesem TCP/IP-gebundenen Netzwerkadapter fest. Diese Methode wird unabhängig vom Netzwerkadapter angewendet.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetWINSServer(
[in] string WINSPrimaryServer,
[in] string WINSSecondaryServer
);
Parameter
-
WINSPrimaryServer [in]
-
IP-Adresse des primären WINS-Servers.
Hinweis
Überprüfen Sie immer die Gültigkeit dieser IP-Adresse, wenn sie von einer unbekannten Quelle oder einer Quelle stammt, der Sie nicht vertrauen.
-
WINSSecondaryServer [in]
-
IP-Adresse des sekundären WINS-Servers.
Hinweis
Überprüfen Sie immer die Gültigkeit dieser IP-Adresse, wenn sie von einer unbekannten Quelle oder einer Quelle stammt, der Sie nicht vertrauen.
Rückgabewert
Gibt bei erfolgreicher Fertigstellung den ganzzahligen Wert 0 (Null) und eine beliebige andere Zahl zurück, um einen Fehler anzuzeigen. Weitere Informationen zu Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
Erfolgreicher Abschluss, kein Neustart erforderlich
-
0
Erfolgreicher Abschluss, kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss, Neustart erforderlich.
-
Die Methode wird auf dieser Plattform nicht unterstützt.
-
64
Die Methode wird auf dieser Plattform nicht unterstützt.
-
Unbekannter Fehler
-
65
Unbekannter Fehler.
-
Ungültige Subnetzmaske
-
66
Ungültige Subnetzmaske.
-
Fehler beim Verarbeiten einer zurückgegebenen Instanz
-
67
Fehler beim Verarbeiten eines zurückgegebenen instance.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als 5 Gateways angegeben
-
69
Mehr als fünf Gateways angegeben.
-
Ungültige IP-Adresse
-
70
Ungültige IP-Adresse.
-
Ungültige Gateway-IP-Adresse
-
71
Ungültige Gateway-IP-Adresse.
-
Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen
-
72
Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen.
-
Ungültiger Domänenname
-
73
Ungültiger Domänenname.
-
Ungültiger Hostname
-
74
Ungültiger Hostname.
-
Kein primärer/sekundärer WINS-Server definiert
-
75
Kein primärer oder sekundärer WINS-Server definiert.
-
Ungültige Datei
-
76
Ungültige Datei
-
Ungültiger Systempfad
-
77
Ungültiger Systempfad.
-
Fehler beim Kopieren der Datei
-
78
Fehler beim Kopieren der Datei.
-
Ungültiger Sicherheitsparameter
-
79
Ungültiger Sicherheitsparameter.
-
Tcp/IP-Dienst kann nicht konfiguriert werden
-
80
Der TCP/IP-Dienst kann nicht konfiguriert werden.
-
Dhcp-Dienst kann nicht konfiguriert werden
-
81
Der DHCP-Dienst kann nicht konfiguriert werden.
-
Dhcp-Lease kann nicht verlängert werden
-
82
Dhcp-Lease kann nicht verlängert werden.
-
Dhcp-Lease kann nicht freigegeben werden
-
83
Dhcp-Lease kann nicht freigegeben werden.
-
IP-Adresse auf adapter nicht aktiviert
-
84
DIE IP-Adresse ist auf dem Adapter nicht aktiviert.
-
IPX auf adapter nicht aktiviert
-
85
IPX auf adapter nicht aktiviert.
-
Frame-/Netzwerknummerngrenzfehler
-
86
Frame- oder Netzwerknummerngrenzfehler.
-
Ungültiger Frametyp
-
87
Ungültiger Frametyp.
-
Ungültige Netzwerknummer
-
88
Ungültige Netzwerknummer.
-
Doppelte Netzwerknummer
-
89
Doppelte Netzwerknummer.
-
Parameter außerhalb der Grenzen
-
90
Parameter außerhalb der Grenzen.
-
Zugriff verweigert
-
91
Zugriff verweigert.
-
Nicht genügend Arbeitsspeicher
-
92
Nicht genügend Arbeitsspeicher.
-
Bereits vorhanden
-
93
Ist bereits vorhanden.
-
Pfad, Datei oder Objekt nicht gefunden
-
94
Pfad, Datei oder Objekt nicht gefunden.
-
Dienst kann nicht benachrichtigt werden
-
95
Dienst kann nicht benachrichtigt werden.
-
Benachrichtigung des DNS-Diensts nicht möglich
-
96
Der DNS-Dienst kann nicht benachrichtigt werden.
-
Schnittstelle nicht konfigurierbar
-
97
Schnittstelle nicht konfigurierbar.
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
Nicht alle DHCP-Leases konnten freigegeben oder erneuert werden.
-
DHCP für den Adapter nicht aktiviert
-
100
DHCP ist für den Adapter nicht aktiviert.
-
Andere
-
101 4294967295
Bemerkungen
Wenn sowohl WINSPrimaryServer als auch WINSSecondaryServer auf "" (eine leere Zeichenfolge) festgelegt sind, rückgängig machen explizite WINS-Server zurück zu DHCP.
Beispiele
Das Zuweisen einer IP-Adresse, die aus einer Datenbank abgerufen wurde VBScript-Codebeispiel sucht einen Computer in einer Datenbank und weist diesem Computer die angegebene IP-Adresse zu.
Im folgenden VBScript-Codebeispiel wird der primäre und sekundäre WINS-Server für einen TCP/IP-gebundenen Netzwerkadapter festgelegt.
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
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|