Funzione GetIfTable2

La funzione GetIfTable2 recupera la tabella dell'interfaccia MIB-II.

Sintassi

NETIOAPI_API GetIfTable2(
  _Out_ PMIB_IF_TABLE2 *Table
);

Parametri

• tabella [out]
  Puntatore a un buffer che riceve la tabella delle interfacce in una struttura MIB_IF_TABLE2.

Valore restituito

GetIfTable2 restituisce STATUS_SUCCESS se la funzione ha esito positivo.

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

Osservazioni

La funzione GetIfTable2 enumera le interfacce logiche e fisiche in un computer locale e restituisce queste informazioni in una struttura MIB_IF_TABLE2.

Il driver può usare una funzione simile, GetIfTable2Ex, per specificare il livello di interfacce da restituire. Una chiamata alla funzione GetIfTable2Ex con il parametro Level impostato su MibIfTableNormal recupera gli stessi risultati della chiamata alla funzione GetIfTable2.

getIfTable2 restituisce le interfacce in una struttura MIB_IF_TABLE2 nel buffer a cui punta il parametro Table. La struttura MIB_IF_TABLE2 contiene un conteggio delle interfacce e una matrice di strutture MIB_IF_ROW2 per ogni interfaccia. GetIfTable2 alloca memoria per la struttura MIB_IF_TABLE2 e le voci MIB_IF_ROW2 in questa struttura. Quando queste strutture restituite non sono più necessarie, il driver deve liberare la memoria chiamando FreeMibTable.

Si noti che la struttura MIB_IF_TABLE2 restituita a cui punta il parametro Table potrebbe contenere spaziatura interna per l'allineamento tra il membro NumEntries e la prima voce di matrice MIB_IF_ROW2 nel membro Table della struttura MIB_IF_TABLE2. La spaziatura interna per l'allineamento potrebbe essere presente anche tra le voci della matrice MIB_IF_ROW2. Qualsiasi accesso a una voce di matrice MIB_IF_ROW2 deve presupporre che la spaziatura interna esista.

Fabbisogno

Vedere anche

FreeMibTable

GetIfTable2Ex

MIB_IF_TABLE2

MIB_IF_ROW2