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