Método SetGateways da classe Win32_NetworkAdapterConfiguration

O método de classe WMISetGateways especifica uma lista de gateways para roteamento de pacotes para uma sub-rede diferente da sub-rede à qual o adaptador de rede está conectado.

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 SetGateways(
  [in]           string DefaultIPGateway[],
  [in, optional] uint16 GatewayCostMetric[]
);

Parâmetros

DefaultIPGateway [in]

Lista de endereços IP para gateways em que os pacotes de rede são roteado.

GatewayCostMetric [in, opcional]

Atribui um valor que varia de 1 a 9999, que é usado para calcular as rotas mais rápidas e confiáveis. Os valores desse parâmetro correspondem aos valores no parâmetro DefaultIPGateway . O valor padrão de um gateway é 1.

Valor retornado

Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando uma reinicialização não é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e qualquer outro valor 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, reinicialização necessária

1

Método sem suporte nesta plataforma

64

Método sem suporte quando a NIC está no modo DHCP.

Falha desconhecida

65

Máscara de sub-rede inválida

66

Ocorreu um erro ao processar uma Instância que foi retornada

67

Parâmetro de entrada inválido

68

Mais de 5 gateways especificados

69

Endereço IP inválido

70

Endereço IP de gateway inválido

71

Erro ao acessar o Registro para obter as informações solicitadas

72

Nome de domínio inválido

73

Nome de host inválido

74

Nenhum servidor WINS primário/secundário definido

75

Arquivo inválido

76

Caminho do sistema inválido

77

Falha na cópia do arquivo

78

Parâmetro de segurança inválido

79

Não é possível configurar o serviço TCP/IP

80

Não é possível configurar o serviço DHCP

81

Não é possível renovar a concessão de DHCP

82

Não é possível liberar a concessão de DHCP

83

IP não habilitado no adaptador

84

IPX não habilitado no adaptador

85

Erro de limites de número de quadro/rede

86

Tipo de quadro inválido

87

Número de rede inválido

88

Número de rede duplicado

89

Parâmetro fora dos limites

90

Acesso negado

91

Memória insuficiente

92

Já existe

93

Caminho, arquivo ou objeto não encontrado

94

Não é possível notificar o serviço

95

Não é possível notificar o serviço DNS

96

Interface não configurável

97

Nem todas as concessões dhcp poderiam ser liberadas/renovadas

98

DHCP não habilitado no adaptador

100

Outros

101 4294967295

Comentários

Esse método só funciona quando a NIC (Placa de Interface de Rede) está no modo IP estático.

Para limpar o gateway, defina seu gateway como o mesmo IP que você usa em EnableStatic.

Exemplos

O exemplo Modificar os Gateways para um VBScript do Adaptador de Rede configura dois gateways para um adaptador de rede.

O exemplo Atribuir um Endereço IP Estático VBScript define o endereço IP e o gateway de um computador.

O IP estático e, em seguida, ingressar em um domínio de exemplo do PowerShell auxilia na recompilação de computadores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes de hardware do sistema de computador

Win32_NetworkAdapterConfiguration

Tarefas do WMI: Rede

Tarefas do WMI: contas e domínios

Suporte a IPv6 e IPv4 no WMI