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

Siehe auch

Hardwareklassen des Computersystems

Win32_NetworkAdapterConfiguration

WMI-Aufgaben: Netzwerk

WMI-Aufgaben: Konten und Domänen

IPv6- und IPv4-Unterstützung in WMI