Condividi tramite


Funzione SetIfEntry (iphlpapi.h)

La funzione SetIfEntry imposta lo stato amministrativo di un'interfaccia.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD SetIfEntry(
  [in] PMIB_IFROW pIfRow
);

Parametri

[in] pIfRow

Puntatore a una struttura MIB_IFROW . Il membro dwIndex di questa struttura specifica l'interfaccia su cui impostare lo stato amministrativo. Il membro dwAdminStatus specifica il nuovo stato amministrativo. Il membro dwAdminStatus può essere uno dei valori seguenti.

Valore Significato
MIB_IF_ADMIN_STATUS_UP
L'interfaccia è abilitata in modo amministrativo.
MIB_IF_ADMIN_STATUS_DOWN
L'interfaccia è disabilitata in modo amministrativo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito Descrizione
ERROR_ACCESS_DENIED
Accesso negato. Questo errore viene restituito in Windows Vista e versioni successive in diverse condizioni che includono quanto segue: l'utente non dispone dei privilegi amministrativi necessari nel computer locale o l'applicazione non è in esecuzione in una shell avanzata come amministratore predefinito (amministratore RunAs).
ERROR_FILE_NOT_FOUND
Non è possibile trovare il file specificato. Questo errore viene restituito in Windows Vista e versioni successive se non è stato possibile trovare l'interfaccia di rete specificata dal membro dwIndex della struttura MIB_IFROW puntata dal parametro pIfRow .
ERROR_INVALID_PARAMETER
Un parametro non valido è stato passato alla funzione. Questo errore viene restituito se un puntatore NULL viene passato nel parametro pIfRow o il membro dwIndex del MIB_IFROW indicato dal parametro pIfRow non è stato specificato. Questo errore viene restituito anche in Windows Server 2003 e versioni precedenti se non è stato possibile trovare l'interfaccia di rete specificata dal membro dwIndex della struttura MIB_IFROW a cui punta il parametro pIfRow .
ERROR_NOT_SUPPORTED
La richiesta non è supportata. Questo errore viene restituito in Windows Server 2003 e versioni precedenti se non è configurato alcun stack TCP/IP nel computer locale.
Altri
Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione SetIfEntry viene usata per impostare lo stato amministrativo di un'interfaccia in un computer locale.

Il membro dwIndex nella struttura MIB_IFROW puntato al parametro pIfRow deve essere inizializzato nell'indice dell'interfaccia.

La funzione SetIfEntry avrà esito negativo se il membro dwIndex del MIB_IFROW indicato dal parametro pIfRow non corrisponde a un'interfaccia esistente nel computer locale.

In Windows Vista e versioni successive, la funzione SetIfEntry può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se SetIfEntry viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata alla funzione avrà esito negativo e viene restituita ERROR_ACCESS_DENIED.

La funzione SetIfEntry può anche non riuscire a causa del controllo account utente (UAC) in Windows Vista e versioni successive. Se un'applicazione contenente questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito negativo a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel per richiedereAdministrator. Se l'applicazione manca di questo file manifesto, un utente ha eseguito l'accesso come membro del gruppo Administrators diverso dall'amministratore predefinito, deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) per la riuscita di questa funzione.

Nota In Windows NT 4.0 e Windows 2000 e versioni successive, questa funzione esegue un'operazione con privilegi. Per eseguire correttamente questa funzione, il chiamante deve essere connesso come membro del gruppo Administrators o del gruppo NetworkConfigurationOperators.
 

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione iphlpapi.h
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche

GetIfEntry

GetIfTable

Informazioni di riferimento sulla funzione helper IP

Pagina iniziale dell'helper IP

MIB_IFROW

MIB_IFTABLE