SetMTU-Methode der Win32 _ NetworkAdapterConfiguration-Klasse
Die statische Methode der SetMTU WMI-Klasse wird verwendet, um die standardmäßige maximale Übertragungseinheit (Maximum Transmission Unit, MTU) für eine Netzwerkschnittstelle festzulegen.
In diesem Thema wird die 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]
-
Standardmäßige maximale Übertragungseinheit (Maximum Transmission Unit, MTU) für eine Netzwerkschnittstelle. Der Bereich dieses Werts umfasst die mindeste Paketgröß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 (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-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.
-
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 einer zurückgegebenen Instanz.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als 5 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 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
Es wurde 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 erneuert werden.
-
DHCP-Lease kann nicht veröffentlicht werden
-
83
DHCP-Lease kann nicht veröffentlicht werden.
-
IP auf Adapter nicht aktiviert
-
84
DIE IP-Adresse ist auf dem Adapter nicht aktiviert.
-
IPX auf Adapter nicht aktiviert
-
85
IPX für Adapter nicht aktiviert.
-
Frame-/Netzwerknummern-Begrenzungsfehler
-
86
Frame- oder Netzwerknummern-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 können freigegeben oder erneuert 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 überträgt. 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 die Standardmäßige MTU des Netzwerks verwendet. Werte kleiner als 68 führen dazu, dass der Transport eine MTU von 68 verwendet.
Beispiele
Im VBScript-Beispiel Ändern der MTU für alle Netzwerkadapter wird die maximale Übertragungseinheit für alle auf einem Computer installierten Netzwerkadapter konfiguriert.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|