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. Al termine della restituzione, i campi di 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 ha esito negativo, InitializeIpInterfaceEntry restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Un parametro non valido è stato passato alla funzione. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Row |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
In output, i membri della struttura MIB_IPINTERFACE_ROW a cui punta il parametro Row vengono inizializzati come indicato di seguito.
Famiglia
Impostare su AF_UNSPEC.InterfaceLuid
Impostare su un valore non specificato.Tutti gli altri membri
Imposta 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 .
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |