Metodo SetGateways della classe Win32_NetworkAdapterConfiguration

Il metodo della classeSetGatewaysWMI specifica un elenco di gateway per il routing di pacchetti a una subnet diversa dalla subnet a cui è connessa la scheda di rete.

In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.

Sintassi

uint32 SetGateways(
  [in]           string DefaultIPGateway[],
  [in, optional] uint16 GatewayCostMetric[]
);

Parametri

DefaultIPGateway [in]

Elenco di indirizzi IP ai gateway in cui vengono instradati i pacchetti di rete.

GatewayCostMetric [in, facoltativo]

Assegna un valore compreso tra 1 e 9999, che viene usato per calcolare le route più veloci e affidabili. I valori di questo parametro corrispondono ai valori nel parametro DefaultIPGateway . Il valore predefinito per un gateway è 1.

Valore restituito

Restituisce un valore pari a 0 (zero) per un completamento riuscito quando non è necessario un riavvio, 1 (uno) per un completamento riuscito quando è necessario un riavvio e qualsiasi altro valore se si verifica un errore. Per altre informazioni sui codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Completamento completato, nessun riavvio necessario

0

Completamento completato, riavvio necessario

1

Metodo non supportato in questa piattaforma

64

Metodo non supportato quando la scheda di interfaccia di rete è in modalità DHCP.

Errore sconosciuto

65

Subnet mask non valida

66

Errore durante l'elaborazione di un'istanza restituita

67

Parametro di input non valido

68

Più di 5 gateway specificati

69

Indirizzo IP non valido

70

Indirizzo IP del gateway non valido

71

Errore durante l'accesso al Registro di sistema per le informazioni richieste

72

Nome di dominio non valido

73

Nome host non valido

74

Nessun server WINS primario/secondario definito

75

File non valido

76

Percorso di sistema non valido

77

Copia file non riuscita

78

Parametro di sicurezza non valido

79

Impossibile configurare il servizio TCP/IP

80

Impossibile configurare il servizio DHCP

81

Impossibile rinnovare il lease DHCP

82

Impossibile rilasciare il lease DHCP

83

IP non abilitato nella scheda

84

IPX non abilitato nella scheda

85

Errore di limiti di frame/numero di rete

86

Tipo di frame non valido

87

Numero di rete non valido

88

Numero di rete duplicato

89

Parametro fuori dai limiti

90

Accesso negato

91

Memoria insufficiente

92

Esiste già

93

Percorso, file o oggetto non trovato

94

Impossibile inviare una notifica al servizio

95

Non è possibile inviare una notifica al servizio DNS

96

Interfaccia non configurabile

97

Non tutti i lease DHCP potrebbero essere rilasciati/rinnovati

98

DHCP non abilitato nella scheda

100

Altri

101 4294967295

Commenti

Questo metodo funziona solo quando la scheda di interfaccia di rete (NIC) è in modalità IP statica.

Per cancellare il gateway, impostare il gateway sullo stesso indirizzo IP usato in EnableStatic.

Esempio

L'esempio Modify the Gateways for a Network Adapter VBScript configura due gateway per una scheda di rete.

L'esempio Assign a Static IP Address VBScript imposta l'indirizzo IP e il gateway di un computer.

L'indirizzo IP statico e quindi l'aggiunta a un dominio di esempio di PowerShell semplifica la ricompilazione dei computer.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Spazio dei nomi
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

Classi hardware del sistema computer

Win32_NetworkAdapterConfiguration

Attività WMI: Rete

Attività WMI: account e domini

Supporto IPv6 e IPv4 in WMI