GetIfTable2-Funktion
Die GetIfTable2-Funktion ruft die MIB-II-Schnittstellentabelle ab.
Syntax
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parameter
- Tabelle [out]
Ein Zeiger auf einen Puffer, der die Schnittstellentabelle in einer MIB_IF_TABLE2-Struktur empfängt.
Rückgabewert
GetIfTable2 gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, gibt GetIfTable2 einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Es sind unzureichende Arbeitsspeicherressourcen verfügbar, um den Vorgang abzuschließen. |
| Andere | Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Bemerkungen
Die GetIfTable2-Funktion listet die logischen und physischen Schnittstellen auf einem lokalen Computer auf und gibt diese Informationen in einer MIB_IF_TABLE2-Struktur zurück.
Ihr Treiber kann eine ähnliche Funktion, GetIfTable2Ex, verwenden, um die Ebene der zurückzugebenden Schnittstellen anzugeben. Ein Aufruf der GetIfTable2Ex-Funktion , bei der der Level-Parameter auf MibIfTableNormal festgelegt ist, ruft dieselben Ergebnisse ab wie der Aufruf der GetIfTable2-Funktion .
GetIfTable2 gibt Schnittstellen in einer MIB_IF_TABLE2-Struktur im Puffer zurück, 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. GetIfTable2 ordnet Arbeitsspeicher für die MIB_IF_TABLE2-Struktur und die MIB_IF_ROW2 Einträge in dieser Struktur zu. Wenn diese zurückgegebenen Strukturen nicht mehr benötigt werden, sollte Ihr Treiber den Arbeitsspeicher durch Aufrufen von FreeMibTable freigeben.
Beachten Sie, dass die zurückgegebene MIB_IF_TABLE2 Struktur, auf die der Table-Parameter verweist, möglicherweise 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
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |