Funzione InitializeIpInterfaceEntry

La funzione InitializeIpInterfaceEntry inizializza i membri di una voce di struttura MIB_IPINTERFACE_ROW con valori predefiniti.

Sintassi

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parametri

• riga [in, out]
  Puntatore a una struttura MIB_IPINTERFACE_ROW da inizializzare. In caso di esito positivo, i campi in questo parametro vengono inizializzati con le informazioni predefinite per un'interfaccia nel computer locale.

Valore restituito

initializeIpInterfaceEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.

Se la funzione non riesce, InitializeIpInterfaceEntry restituisce uno dei codici di errore seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se un puntatore NULL viene passato nel parametro riga
Altro	Usare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Osservazioni

Nell'output, i membri della struttura MIB_IPINTERFACE_ROW a cui punta il parametro riga vengono inizializzati nel modo seguente.

• famiglia
  Impostare su AF_UNSPEC.

• InterfaceLuid
  Impostare su un valore non specificato.

• Tutti gli altri membri
  Impostare su zero.

Il driver deve usare la funzione InitializeIpInterfaceEntry per inizializzare i campi di una voce di struttura MIB_IPINTERFACE_ROW con valori predefiniti. Un driver può quindi modificare i campi nella voce MIB_IPINTERFACE_ROW che vuole modificare e quindi chiamare la funzione SetIpInterfaceEntry.

Fabbisogno

Piattaforma di destinazione	universale
Versione	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	Netioapi.h (include Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL

Vedere anche

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry