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
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