Método SetMTU da classe Win32_NetworkAdapterConfiguration
O método estático da classe WMISetMTU é usado para definir a MTU (Unidade de Transmissão Máxima) padrão para um adaptador de rede.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 SetMTU(
[in] uint32 MTU
);
Parâmetros
-
MTU [in]
-
MTU (Unidade de Transmissão Máxima) padrão para um adaptador de rede. O intervalo desse valor abrange o tamanho mínimo do pacote (68) para a MTU compatível com a rede subjacente.
Valor retornado
Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando nenhuma reinicialização é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e um número diferente se houver um erro. Para obter mais informações sobre códigos de erro, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
-
Conclusão bem-sucedida, nenhuma reinicialização necessária
-
0
Conclusão bem-sucedida. Nenhuma reinicialização é necessária.
-
Conclusão bem-sucedida, reinicialização necessária
-
1
Conclusão bem-sucedida. A reinicialização é obrigatória.
-
Método sem suporte nesta plataforma
-
64
Método sem suporte nesta plataforma.
-
Falha desconhecida
-
65
Falha desconhecida.
-
Máscara de sub-rede inválida
-
66
Máscara de sub-rede inválida.
-
Ocorreu um erro ao processar uma Instância que foi retornada
-
67
Ocorreu um erro ao processar uma instância que foi retornada.
-
Parâmetro de entrada inválido
-
68
Parâmetro de entrada inválido.
-
Mais de 5 gateways especificados
-
69
Mais de cinco gateways especificados.
-
Endereço IP inválido
-
70
Endereço IP inválido.
-
Endereço IP do gateway inválido
-
71
Endereço IP do gateway inválido.
-
Ocorreu um erro ao acessar o Registro para obter as informações solicitadas
-
72
Ocorreu um erro ao acessar o registro para obter as informações solicitadas.
-
Nome de domínio inválido
-
73
Nome de domínio inválido.
-
Nome do host inválido
-
74
Nome do host inválido.
-
Nenhum servidor WINS primário/secundário definido
-
75
Nenhum servidor WINS primário ou secundário definido.
-
Arquivo inválido
-
76
Arquivo inválido.
-
Caminho do sistema inválido
-
77
Caminho do sistema inválido.
-
Falha na cópia do arquivo
-
78
Falha na cópia do arquivo.
-
Parâmetro de segurança inválido
-
79
Parâmetro de segurança inválido.
-
Não é possível configurar o serviço TCP/IP
-
80
Não é possível configurar o serviço TCP/IP.
-
Não é possível configurar o serviço DHCP
-
81
Não é possível configurar o serviço DHCP.
-
Não é possível renovar a concessão do DHCP
-
82
Não é possível renovar a concessão do DHCP.
-
Não é possível liberar a concessão do DHCP
-
83
Não é possível liberar a concessão do DHCP.
-
IP não habilitado no adaptador
-
84
IP não habilitado no adaptador.
-
IPX não habilitado no adaptador
-
85
IPX não habilitado no adaptador.
-
Erro de limites de número de quadro/rede
-
86
Erro de limites de quadro ou número de rede.
-
Tipo de quadro inválido
-
87
Tipo de quadro inválido.
-
Número de rede inválido
-
88
Número de rede inválido.
-
Número de rede duplicado
-
89
Número de rede duplicado.
-
Parâmetro fora dos limites
-
90
Parâmetro fora dos limites.
-
Acesso negado
-
91
Acesso negado.
-
Memória insuficiente
-
92
Sem memória.
-
Já existe
-
93
Já existe.
-
Caminho, arquivo ou objeto não encontrado
-
94
Caminho, arquivo ou objeto não encontrado.
-
Não é possível notificar o serviço
-
95
Não é possível notificar o serviço.
-
Não é possível notificar o serviço DNS
-
96
Não é possível notificar o serviço DNS.
-
Interface não configurável
-
97
Interface não configurável.
-
Nem todas as concessões dhcp poderiam ser liberadas/renovadas
-
98
Nem todas as concessões DHCP podem ser liberadas ou renovadas.
-
DHCP não habilitado no adaptador
-
100
O DHCP não está habilitado no adaptador.
-
Outros
-
101 4294967295
Comentários
A MTU é o tamanho máximo do pacote (em bytes) que um transporte transmitirá pela rede subjacente. O tamanho inclui o cabeçalho de transporte.
Observe que um datagrama de IP pode abranger vários pacotes. Valores maiores que o padrão para a rede subjacente resultam no transporte usando a MTU padrão de rede. Valores menores que 68 resultam no transporte usando uma MTU de 68.
Exemplos
O exemplo Modificar a MTU para todos os Adaptadores de Rede VBScript configura a unidade de transmissão máxima para todos os adaptadores de rede instalados em um computador.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|