Metodo EnableStatic della classe Win32_NetworkAdapterConfiguration
Il metodo della classe WMI EnableStaticabilita l'indirizzamento TCP/IP statico per la scheda di rete di destinazione. Di conseguenza, DHCP per questa scheda di rete è disabilitato.
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 EnableStatic(
[in] string IPAddress[],
[in] string SubnetMask[]
);
Parametri
-
IPAddress [in]
-
Elenca tutti gli indirizzi IP statici per la scheda di rete corrente.
Esempio: 155.34.22.0.
-
SubnetMask [in]
-
Subnet mask che integrano i valori nel parametro IPAddress .
Esempio: 255.255.0.0.
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. Per altre informazioni, vedere la sezione Osservazioni.
-
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 nella scheda.
-
2147786788
-
Blocco di scrittura non abilitato. Per altre informazioni, vedere INetCfgLock::AcquireWriteLock.
-
Altri
-
101 4294967295
Osservazioni:
Quando si usa EnableStatic per modificare l'indirizzo IP del computer remoto, durante la connessione tramite tale scheda, è probabile che si verifichi una connessione libera al computer remoto e venga visualizzato un messaggio di errore RPC non disponibile. le impostazioni vengono tuttavia modificate. Per evitare questo scenario, è consigliabile modificare le impostazioni gateway e/o DNS prima di impostare l'indirizzo IP della scheda.
Quando si usa EnableStatic per assegnare a una scheda una configurazione IP statica, la funzione restituisce un "81 - Impossibile configurare il servizio DHCP" se l'adattatore è già configurato con un indirizzo statico. Tuttavia, la funzione ha ancora esito positivo nell'impostazione con la nuova operazione.
Esempi
Nell'esempio di VBScript seguente viene illustrato come disabilitare 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
Questo script si applica solo ai sistemi basati su NT Modificare le variabili ipaddr e subnet seguenti ai valori che si desidera applicare alla scheda.
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")
ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")
RetVal = Adapter.EnableStatic(ipaddr,subnet)
if RetVal = 0 then
WScript.Echo "DHCP disabled, using static IP address"
else
WScript.Echo "DHCP disable failed"
end if
Nell'esempio Dil seguente viene illustrato come disabilitare 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
Questo script si applica solo ai sistemi basati su NT Modificare le variabili ipaddr e subnet seguenti ai valori che si desidera applicare alla scheda.
use strict;
use Win32::OLE;
my ($Adapter, @ipaddr, @subnet, $RetVal);
eval { $Adapter =
Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };
unless ($@)
{
push @ipaddr, "192.168.144.107";
push @subnet, "255.255.255.0";
$RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);
if ($RetVal == 0)
{
print "\nDHCP disabled, using static IP address\n";
}
else
{
print "\nDHCP disable failed\n";
}
}
else
{
print STDERR "\n", 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 |
|