SetGateways-Methode der Win32 _ NetworkAdapterConfiguration-Klasse
Die WMI-Klassenmethode SetGateways gibt eine Liste von Gateways zum Weiterleiten von Paketen an ein Subnetz an, das sich von dem Subnetz, mit dem der Netzwerkadapter verbunden ist, unterscheiden kann.
In diesem Thema wird Managed Object Format (MOF)-Syntax verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Parameter
-
DefaultIPGateway [ In]
-
Liste der IP-Adressen zu Gateways, an die Netzwerkpakete geroutet werden.
-
GatewayCostMetric [ in, optional]
-
Weist einen Wert zwischen 1 und 9999 zu, der zum Berechnen der schnellsten und zuverlässigsten Routen verwendet wird. Die Werte dieses Parameters entsprechen den Werten im DefaultIPGateway-Parameter. Der Standardwert für ein Gateway ist 1.
Rückgabewert
Gibt den Wert 0 (null) für einen erfolgreichen Abschluss zurück, wenn kein Neustart erforderlich ist, 1 (eins) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und jeden anderen Wert, wenn ein Fehler auftritt. Weitere Informationen zu Fehlercodes finden Sie unter WMI-Fehlerkonstistenzen oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
Erfolgreicher Abschluss, kein Neustart erforderlich
-
0
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
-
Methode wird auf dieser Plattform nicht unterstützt
-
64
Die Methode wird nicht unterstützt, wenn sich die NIC im DHCP-Modus befindet.
-
Unbekannter Fehler
-
65
-
Ungültige Subnetzmaske
-
66
-
Fehler beim Verarbeiten einer instanz, die zurückgegeben wurde
-
67
-
Ungültiger Eingabeparameter
-
68
-
Mehr als fünf Gateways angegeben
-
69
-
Ungültige IP-Adresse
-
70
-
Ungültige Gateway-IP-Adresse
-
71
-
Fehler beim Zugreifen auf die Registrierung für die angeforderten Informationen
-
72
-
Ungültiger Domänenname
-
73
-
Ungültiger Hostname
-
74
-
Kein primärer/sekundärer WINS-Server definiert
-
75
-
Ungültige Datei
-
76
-
Ungültiger Systempfad
-
77
-
Fehler beim Kopieren der Datei
-
78
-
Ungültiger Sicherheitsparameter
-
79
-
TCP/IP-Dienst kann nicht konfiguriert werden
-
80
-
DHCP-Dienst kann nicht konfiguriert werden
-
81
-
DHCP-Lease kann nicht verlängert werden
-
82
-
DHCP-Lease kann nicht veröffentlicht werden
-
83
-
IP-Adresse auf Adapter nicht aktiviert
-
84
-
IPX auf Adapter nicht aktiviert
-
85
-
Frame-/Netzwerknummer-Begrenzungsfehler
-
86
-
Ungültiger Frametyp
-
87
-
Ungültige Netzwerknummer
-
88
-
Doppelte Netzwerknummer
-
89
-
Parameter über grenzenlose Grenzen
-
90
-
Zugriff verweigert
-
91
-
Nicht genügend Arbeitsspeicher
-
92
-
Bereits vorhanden
-
93
-
Pfad, Datei oder Objekt nicht gefunden
-
94
-
Dienst kann nicht benachrichtigt werden
-
95
-
DNS-Dienst kann nicht benachrichtigt werden
-
96
-
Schnittstelle nicht konfigurierbar
-
97
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
-
DHCP auf Adapter nicht aktiviert
-
100
-
Andere
-
101 4294967295
Bemerkungen
Diese Methode funktioniert nur, wenn sich die Netzwerkschnittstellenkarte (NIC) im statischen IP-Modus befindet.
Um das Gateway zu löschen, legen Sie ihr Gateway auf die gleiche IP-Adresse fest, die Sie für EnableStatic verwenden.
Beispiele
Im VBScript-Beispiel Ändern der Gateways für einen Netzwerkadapter werden zwei Gateways für einen Netzwerkadapter konfiguriert.
Im VbScript-Beispiel Zuweisen einer statischen IP-Adresse werden die IP-Adresse und das Gateway eines Computers bestimmt.
Das PowerShell-Beispiel statische IP und anschließender Beitritt zu einer Domäne hilft bei der Neuerstellung von Computern.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|