Metodo EnableDHCP della classe Win32_NetworkAdapterConfiguration
Il metodo della classe WMI EnableDHCPabilita il protocollo DHCP (Dynamic Host Configuration Protocol) per il servizio con questa scheda di rete. DHCP consente di allocare dinamicamente gli indirizzi IP.
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 EnableDHCP();
Parametri
Questo metodo non presenta parametri.
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 numero 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, nessun riavvio necessario.
-
Completamento completato, riavvio richiesto
-
1
Completamento completato, riavvio richiesto.
-
Metodo non supportato in questa piattaforma
-
64
Metodo non supportato in questa piattaforma.
-
Errore sconosciuto
-
65
Errore sconosciuto.
-
Subnet mask non valida
-
66
Subnet mask non valida.
-
Errore durante l'elaborazione di un'istanza restituita
-
67
Errore durante l'elaborazione di un'istanza restituita.
-
Parametro di input non valido
-
68
Parametro di input non valido.
-
Più di 5 gateway specificati
-
69
Più di cinque gateway specificati.
-
Indirizzo IP non valido
-
70
Indirizzo IP non valido.
-
Indirizzo IP del gateway non valido
-
71
Indirizzo IP del gateway non valido.
-
Errore durante l'accesso al Registro di sistema per le informazioni richieste
-
72
Errore durante l'accesso al Registro di sistema per le informazioni richieste.
-
Nome di dominio non valido
-
73
Nome di dominio non valido.
-
Nome host non valido
-
74
Nome host non valido.
-
Nessun server WINS primario/secondario definito
-
75
Nessun server WINS primario o secondario definito.
-
File non valido
-
76
File non valido.
-
Percorso di sistema non valido
-
77
Percorso di sistema non valido.
-
Copia file non riuscita
-
78
Copia file non riuscita.
-
Parametro di sicurezza non valido
-
79
Parametro di sicurezza non valido.
-
Impossibile configurare il servizio TCP/IP
-
80
Impossibile configurare il servizio TCP/IP.
-
Impossibile configurare il servizio DHCP
-
81
Impossibile configurare il servizio DHCP.
-
Non è possibile rinnovare il lease DHCP
-
82
Impossibile rinnovare il lease DHCP.
-
Non è possibile rilasciare il lease DHCP
-
83
Impossibile rilasciare il lease DHCP.
-
IP non abilitato nell'adapter
-
84
IP non abilitato nella scheda.
-
IPX non abilitato nella scheda
-
85
IPX non abilitato nella scheda.
-
Errore di limiti di frame/numero di rete
-
86
Errore di limiti di frame o numero di rete.
-
Tipo di frame non valido
-
87
Tipo di frame non valido.
-
Numero di rete non valido
-
88
Numero di rete non valido.
-
Numero di rete duplicato
-
89
Numero di rete duplicato.
-
Parametro fuori dai limiti
-
90
Parametro fuori dai limiti.
-
Accesso negato
-
91
Accesso negato.
-
Memoria insufficiente
-
92
Memoria esaurita.
-
Esiste già
-
93
Esiste già.
-
Percorso, file o oggetto non trovato
-
94
Percorso, file o oggetto non trovato.
-
Impossibile inviare una notifica al servizio
-
95
Impossibile inviare una notifica al servizio.
-
Impossibile inviare una notifica al servizio DNS
-
96
Impossibile inviare una notifica al servizio DNS.
-
Interfaccia non configurabile
-
97
Interfaccia non configurabile.
-
Non tutti i lease DHCP potrebbero essere rilasciati/rinnovati
-
98
Non tutti i lease DHCP potrebbero essere rilasciati o rinnovati.
-
DHCP non abilitato per l'adapter
-
100
DHCP non abilitato nell'adattatore.
-
Altri
-
101 4294967295
Osservazioni:
Questo metodo non cancella i gateway predefiniti statici presenti nel computer.
Esempi
Nell'esempio di codice VBScript seguente viene illustrato come abilitare l'uso DHCP in un'istanza di Win32_NetworkAdapterConfiguration . In questo caso si specifica l'adattatore con un indice pari a 0. L'indice corretto deve essere selezionato dalle istanze di Win32_NetworkAdapter per altre interfacce.
Nota
Supportato solo nelle piattaforme NT.
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=0")
RetVal = Adapter.EnableDHCP()
if RetVal = 0 then
WScript.Echo "DHCP Enabled"
else
WScript.Echo "DHCP enable failed"
end if
Nell'esempio di codice Perl seguente viene illustrato come abilitare l'uso DHCP in un'istanza di Win32_NetworkAdapterConfiguration . In questo caso si specifica l'adattatore con un indice pari a 0. L'indice corretto deve essere selezionato dalle istanze di Win32_NetworkAdapter per altre interfacce.
Nota
Supportato solo nelle piattaforme NT.
use strict;
use Win32::OLE;
my ( $Adapter, $RetVal );
eval { $Adapter = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
Get("Win32_NetworkAdapterConfiguration=0"); };
unless ($@)
{
print "\n";
$RetVal = $Adapter->EnableDHCP();
if ( $RetVal == 0)
{
print "DHCP Enabled\n";
}
else
{
print "DHCP enable failed\n";
}
}
else
{
print STDERR Win32::OLE->LastError, "\n";
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|