SetMTU-Methode der Win32_NetworkAdapterConfiguration-Klasse
Die statische Methode der SetMTUWMI-Klasse wird verwendet, um die Standard-MTU (Maximum Transmission Unit) für eine Netzwerkschnittstelle festzulegen.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetMTU(
[in] uint32 MTU
);
Parameter
-
MTU [in]
-
Standard-MTU (Maximum Transmission Unit) für eine Netzwerkschnittstelle. Der Bereich dieses Werts reicht von der Mindestpaketgröße (68) bis zur MTU, die vom zugrunde liegenden Netzwerk unterstützt wird.
Rückgabewert
Gibt den Wert 0 (null) für einen erfolgreichen Abschluss zurück, wenn kein Neustart erforderlich ist, 1 (1) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und eine andere Zahl, wenn ein Fehler vorliegt. 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. Es ist kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss. Neustart ist erforderlich.
-
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
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 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 für den Adapter nicht aktiviert.
-
IPX auf adapter nicht aktiviert
-
85
IPX ist für den Adapter nicht aktiviert.
-
Frame-/Netzwerknummergrenzenfehler
-
86
Frame- oder Netzwerknummerngrenzenfehler.
-
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 können freigegeben oder verlängert werden.
-
DHCP auf adapter nicht aktiviert
-
100
DHCP ist auf dem Adapter nicht aktiviert.
-
Andere
-
101 4294967295
Bemerkungen
Die MTU ist die maximale Paketgröße (in Bytes), die ein Transport über das zugrunde liegende Netzwerk übertragen wird. Die Größe enthält den Transportheader.
Beachten Sie, dass ein IP-Datagramm mehrere Pakete umfassen kann. Werte, die größer als der Standardwert für das zugrunde liegende Netzwerk sind, führen dazu, dass der Transport mithilfe der Netzwerkstandard-MTU erfolgt. Werte, die kleiner als 68 sind, führen zum Transport mit einer MTU von 68.
Beispiele
Im VBScript-Beispiel MTU für alle Netzwerkadapter ändern wird die maximale Übertragungseinheit für alle Netzwerkadapter konfiguriert, die auf einem Computer installiert sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|