SetIPConnectionMetric-Methode der Win32 _ NetworkAdapterConfiguration-Klasse
Mit der SetIPConnectionMetric-Methode wird die Routingmetrik festgelegt, die diesem IP-gebundenen Adapter zugeordnet ist.
In diesem Thema wird Managed Object Format -Syntax (MOF) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetIPConnectionMetric(
[in] uint32 IPConnectionMetric
);
Parameter
-
IPConnectionMetric [ In]
-
Gibt die Kosten für die Verwendung der konfigurierten Routen für diesen IP-gebundenen Adapter an. Der Wert wird für diese Routen in der IP-Routingtabelle gewichtet. Wenn die Routingtabelle mehrere Routen zu einem Ziel enthält, wird die Route mit der niedrigsten Metrik verwendet. Der Bereich der gültigen Werte liegt zwischen 1 und 9999. Der Standardwert 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 eine andere Zahl, 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, kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss, Neustart erforderlich.
-
Methode wird auf dieser Plattform nicht unterstützt
-
64
Methode wird auf dieser Plattform nicht unterstützt.
-
Unbekannter Fehler
-
65
Unbekannter Fehler.
-
Ungültige Subnetzmaske
-
66
Ungültige Subnetzmaske.
-
Fehler beim Verarbeiten einer instanz, die zurückgegeben wurde
-
67
Fehler beim Verarbeiten einer instanz, die zurückgegeben wurde.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als fünf Gateways angegeben
-
69
Es wurden 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 Zugreifen auf die Registrierung für die angeforderten Informationen
-
72
Fehler beim Zugreifen 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
DHCP-Dienst kann nicht konfiguriert werden.
-
DHCP-Lease kann nicht verlängert werden
-
82
DHCP-Lease kann nicht erneuert werden.
-
DHCP-Lease kann nicht veröffentlicht werden
-
83
DHCP-Lease kann nicht veröffentlicht werden.
-
IP-Adresse auf Adapter nicht aktiviert
-
84
DIE IP-Adresse ist auf dem Adapter nicht aktiviert.
-
IPX auf Adapter nicht aktiviert
-
85
IPX ist auf adapter nicht aktiviert.
-
Frame-/Netzwerknummer-Begrenzungsfehler
-
86
Frame- oder Netzwerknummer-Begrenzungsfehler.
-
Ungültiger Frametyp
-
87
Ungültiger Frametyp.
-
Ungültige Netzwerknummer
-
88
Ungültige Netzwerknummer.
-
Doppelte Netzwerknummer
-
89
Doppelte Netzwerknummer.
-
Parameter über grenzenlose Grenzen
-
90
Parameter, der nicht an grenzende Grenzen gebunden ist.
-
Zugriff verweigert
-
91
Der Zugriff wurde 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 wurden nicht gefunden.
-
Dienst kann nicht benachrichtigt werden
-
95
Der Dienst kann nicht benachrichtigt werden.
-
DNS-Dienst kann nicht benachrichtigt werden
-
96
Der DNS-Dienst kann nicht benachrichtigt werden.
-
Schnittstelle nicht konfigurierbar
-
97
Die Schnittstelle kann nicht konfiguriert werden.
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
Nicht alle DHCP-Leases konnten freigegeben oder erneuert werden.
-
DHCP auf Adapter nicht aktiviert
-
100
DHCP ist auf dem Adapter nicht aktiviert.
-
Andere
-
101 4294967295
Beispiele
Im VbScript-Beispiel Ändern der IP-Verbindungsmetrik für einen Netzwerkadapter wird die IP-Verbindungsmetrik für einen Netzwerkadapter auf 100 fest.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista, Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008, Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|