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	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi hardware del sistema informatico

Win32_NetworkAdapterConfiguration

Attività WMI: Rete

Attività WMI: account e domini

Supporto IPv6 e IPv4 in WMI