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

Weitere Informationen

Hardwareklassen des Computersystems

Win32 _ NetworkAdapterConfiguration

WMI-Aufgaben: Netzwerk

WMI-Aufgaben: Konten und Domänen

IPv6- und IPv4-Unterstützung in WMI