Funzione GetIfEntry2
La funzione GetIfEntry2 recupera informazioni per l'interfaccia specificata in un computer locale.
Importante
Per gli sviluppatori di driver, è consigliabile usare GetIfEntry2Ex con MibIfEntryNormalWithoutStatistics, quando possibile, per evitare un deadlock durante la manutenzione degli IDE NDIS.
Sintassi
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Parametri
- Riga [in, out]
Puntatore a una struttura MIB_IF_ROW2 che, in caso di esito positivo, riceve informazioni per un'interfaccia nel computer locale. All'input, il driver deve impostare il membro InterfaceLuid o il membro InterfaceIndex della struttura MIB_IF_ROW2 sull'interfaccia per cui recuperare le informazioni.
Valore restituito
GetIfEntry2 restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, GetIfEntry2 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 viene passato un puntatore NULL nel parametro Row . |
| STATUS_NOT_FOUND | Impossibile trovare l'interfaccia specificata. Questo errore viene restituito se la funzione non riesce a trovare l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_IF_ROW2 a cui punta il parametro Row . |
| Altro | Utilizzare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Osservazioni:
All'input, il driver deve inizializzare almeno il membro InterfaceLuid o InterfaceIndex nella struttura MIB_IF_ROW2 passata nel parametro Row. I membri vengono utilizzati nell'ordine elencato in precedenza. Pertanto, se si specifica InterfaceLuid , questo membro viene usato per determinare l'interfaccia. Se non è stato impostato alcun valore per il membro InterfaceLuid (il valore di questo membro è stato impostato su zero), il membro InterfaceIndex viene usato successivamente per determinare l'interfaccia.
Nell'output vengono compilati i campi rimanenti della struttura MIB_IF_ROW2 a cui punta il parametro Row .
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 |