GetIfTable2-Funktion (netioapi.h)

Artikel
02/29/2024

Die GetIfTable2-Funktion ruft die MIB-II-Schnittstellentabelle ab.

Syntax

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

Parameter

[out] Table

Ein Zeiger auf einen Puffer, der die Schnittstellentabelle in einer MIB_IF_TABLE2-Struktur empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_NOT_ENOUGH_MEMORY	Es sind unzureichende Arbeitsspeicherressourcen verfügbar, um den Vorgang abzuschließen.
Andere	Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

The
Die GetIfTable2-Funktion listet die logischen und physischen Schnittstellen auf einem lokalen System auf und gibt diese Informationen in einer MIB_IF_TABLE2-Struktur zurück. GetIfTable2 ist eine erweiterte Version der GetIfTable-Funktion .

Eine ähnliche GetIfTable2Ex-Funktion kann verwendet werden, um die Ebene der zurückzugebenden Schnittstellen anzugeben. Das Aufrufen der GetIfTable2Ex-Funktion mit dem Level-Parameter , der auf MibIfTableNormal festgelegt ist, ruft die gleichen Ergebnisse wie das Aufrufen der GetIfTable2-Funktion ab.

Schnittstellen werden in einer MIB_IF_TABLE2-Struktur im Puffer zurückgegeben, auf den der Table-Parameter verweist. Die MIB_IF_TABLE2-Struktur enthält eine Schnittstellenanzahl und ein Array von MIB_IF_ROW2 Strukturen für jede Schnittstelle. Der Arbeitsspeicher wird von der GetIfTable2-Funktion für die MIB_IF_TABLE2-Struktur und die MIB_IF_ROW2 Einträge in dieser Struktur zugewiesen. Wenn diese zurückgegebenen Strukturen nicht mehr benötigt werden, geben Sie den Arbeitsspeicher durch Aufrufen der FreeMibTable frei.

Beachten Sie, dass die zurückgegebene MIB_IF_TABLE2 Struktur, auf die der Table-Parameter verweist, eine Auffüllung für die Ausrichtung zwischen dem NumEntries-Element und dem ersten MIB_IF_ROW2 Arrayeintrag im Table-Element der MIB_IF_TABLE2-Struktur enthalten kann. Zwischen den MIB_IF_ROW2 Arrayeinträgen kann auch ein Abstand für die Ausrichtung vorhanden sein. Bei jedem Zugriff auf einen MIB_IF_ROW2 Arrayeintrag sollte davon ausgegangen werden, dass eine Auffüllung vorhanden ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll