Metodo SetGateways della classe Win32_NetworkAdapterConfiguration
Il metodo della classe WMI SetGatewaysspecifica 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 un riavvio non è necessario, 1 (uno) per un completamento riuscito quando è necessario un riavvio e qualsiasi altro valore in caso di errore. Per altre informazioni sui codici di errore, vedere Costanti errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.
-
Completamento completato, nessun riavvio necessario
-
0
-
Completamento completato, riavvio richiesto
-
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
-
Non è possibile rinnovare il lease DHCP
-
82
-
Non è possibile rilasciare il lease DHCP
-
83
-
IP non abilitato nell'adapter
-
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
-
Impossibile inviare una notifica al servizio DNS
-
96
-
Interfaccia non configurabile
-
97
-
Non tutti i lease DHCP potrebbero essere rilasciati/rinnovati
-
98
-
DHCP non abilitato per l'adapter
-
100
-
Altri
-
101 4294967295
Osservazioni:
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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|