Funzione GetIfTable2 (netioapi.h)

Articolo
03/05/2024

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