Condividi tramite


Funzione GetIfTable2 (netioapi.h)

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

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
  [out] PMIB_IF_TABLE2 *Table
);

Parametri

[out] Table

Puntatore a un buffer che riceve la tabella delle interfacce in una struttura MIB_IF_TABLE2 .

Valore restituito

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

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

Codice restituito Descrizione
ERROR_NOT_ENOUGH_MEMORY
Per completare l'operazione sono disponibili risorse di memoria insufficienti.
Altri
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

The
La funzione GetIfTable2 enumera le interfacce logiche e fisiche in un sistema locale e restituisce queste informazioni in una struttura MIB_IF_TABLE2 . GetIfTable2 è una versione avanzata della funzione GetIfTable .

È possibile usare una funzione GetIfTable2Ex simile per specificare il livello di interfacce da restituire. La chiamata alla funzione GetIfTable2Ex con il parametro Level impostato su MibIfTableNormal recupera gli stessi risultati della chiamata alla funzione GetIfTable2 .

Le interfacce vengono restituite in una struttura MIB_IF_TABLE2 nel buffer a cui punta il parametro Table . La struttura MIB_IF_TABLE2 contiene un conteggio di interfacce e una matrice di strutture MIB_IF_ROW2 per ogni interfaccia. La memoria viene allocata dalla funzione GetIfTable2 per la struttura MIB_IF_TABLE2 e le voci MIB_IF_ROW2 in questa struttura. Quando queste strutture restituite non sono più necessarie, liberare la memoria chiamando FreeMibTable.

Si noti che la struttura MIB_IF_TABLE2 restituita a cui punta il parametro Table può 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 può 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 possa esistere.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione netioapi.h (include Iphlpapi.h)
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche

FreeMibTable

GetIfTable

GetIfTable2Ex

Informazioni di riferimento sulle funzioni helper IP

MIB_IF_ROW2

MIB_IF_TABLE2