Méthode SetMTU de la classe Win32_NetworkAdapterConfiguration

La méthode statique de classe WMISetMTU est utilisée pour définir l’unité de transmission maximale (MTU) par défaut pour une interface réseau.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 SetMTU(
  [in] uint32 MTU
);

Paramètres

MTU [in]

Unité de transmission maximale (MTU) par défaut pour une interface réseau. La plage de cette valeur couvre la taille de paquet minimale (68) à la MTU prise en charge par le réseau sous-jacent.

Valeur retournée

Retourne une valeur de 0 (zéro) pour une exécution réussie lorsqu’aucun redémarrage n’est requis, 1 (un) pour une exécution réussie lorsqu’un redémarrage est requis et un nombre différent en cas d’erreur. Pour plus d’informations sur les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Achèvement réussi, aucun redémarrage requis

0

Opération terminée correctement. Aucun redémarrage n’est nécessaire.

Achèvement réussi, redémarrage requis

1

Opération terminée correctement. Le redémarrage est nécessaire.

Méthode non prise en charge sur cette plateforme

64

Méthode non prise en charge sur cette plateforme.

Échec inconnu

65

Échec inconnu.

Masque de sous-réseau non valide

66

Masque de sous-réseau non valide.

Une erreur s’est produite lors du traitement d’une instance retournée

67

Une erreur s’est produite lors du traitement d’un instance retourné.

Paramètre d’entrée non valide

68

Paramètre d'entrée non valide.

Plus de 5 passerelles spécifiées

69

Plus de cinq passerelles spécifiées.

Adresse IP non valide

70

Adresse IP non valide.

Adresse IP de la passerelle non valide

71

Adresse IP de la passerelle non valide.

Une erreur s’est produite lors de l’accès au Registre pour les informations demandées

72

Une erreur s’est produite lors de l’accès au Registre pour les informations demandées.

Nom de domaine non valide

73

Nom de domaine non valide.

Nom d’hôte non valide

74

Nom d’hôte non valide.

Aucun serveur WINS principal/secondaire défini

75

Aucun serveur WINS principal ou secondaire défini.

Fichier non valide

76

Fichier non valide.

Chemin d’accès système non valide

77

Chemin d’accès système non valide.

Échec de la copie de fichier

78

Échec de la copie de fichier.

Paramètre de sécurité non valide

79

Paramètre de sécurité non valide.

Impossible de configurer le service TCP/IP

80

Impossible de configurer le service TCP/IP.

Impossible de configurer le service DHCP

81

Impossible de configurer le service DHCP.

Impossible de renouveler le bail DHCP

82

Impossible de renouveler le bail DHCP.

Impossible de libérer le bail DHCP

83

Impossible de libérer le bail DHCP.

ADRESSE IP non activée sur l’adaptateur

84

IP non activée sur l’adaptateur.

IPX non activé sur l’adaptateur

85 %

IPX non activé sur l’adaptateur.

Erreur de limites de numéro de trame/réseau

86

Erreur de limites de trame ou de numéro de réseau.

Type de frame non valide

87

Type de frame non valide.

Numéro de réseau non valide

88

Numéro de réseau non valide.

Numéro de réseau en double

89

Numéro de réseau en double.

Paramètre hors limites

90

Paramètre hors limites.

Accès refusé

91

Accès refusé.

Mémoire insuffisante

92

Mémoire insuffisante.

Existe déjà

93

Existe déjà.

Chemin d’accès, fichier ou objet introuvable

94

Chemin, fichier ou objet introuvable.

Impossible de notifier le service

95

Impossible de notifier le service.

Impossible de notifier le service DNS

96

Impossible de notifier le service DNS.

Interface non configurable

97

Interface non configurable.

Tous les baux DHCP n’ont pas pu être libérés/renouvelés

98

Tous les baux DHCP ne peuvent pas être libérés ou renouvelés.

DHCP non activé sur l’adaptateur

100

DHCP n’est pas activé sur l’adaptateur.

Autres

101 4294967295

Notes

La MTU est la taille de paquet maximale (en octets) qu’un transport transmet sur le réseau sous-jacent. La taille inclut l’en-tête de transport.

Notez qu’un datagramme IP peut s’étendre sur plusieurs paquets. Les valeurs supérieures à la valeur par défaut pour le réseau sous-jacent entraînent le transport à l’aide de la MTU par défaut du réseau. Les valeurs inférieures à 68 entraînent le transport à l’aide d’une MTU de 68.

Exemples

L’exemple VBScript Modifier la MTU pour toutes les cartes réseau configure l’unité de transmission maximale pour toutes les cartes réseau installées sur un ordinateur.

Spécifications

Voir aussi

Classes matérielles du système informatique

Win32_NetworkAdapterConfiguration

Tâches WMI : Mise en réseau

Tâches WMI : Comptes et domaines

Prise en charge d’IPv6 et IPv4 dans WMI