GetInvertedIfStackTable-Funktion (netioapi.h)
Die GetInvertedIfStackTable-Funktion ruft eine Tabelle mit invertierten Netzwerkschnittstellenstapelzeileneinträgen ab, die die Beziehung der Netzwerkschnittstellen in einem Schnittstellenstapel angeben.
Syntax
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetInvertedIfStackTable(
[out] PMIB_INVERTEDIFSTACK_TABLE *Table
);
Parameter
[out] Table
Ein Zeiger auf einen Puffer, der die Tabelle mit invertierten Schnittstellenstapelzeileneinträgen in einer MIB_INVERTEDIFSTACK_TABLE-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 |
|---|---|
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn im Table-Parameter ein NULL-Zeiger übergeben wird. |
|
Es sind unzureichende Arbeitsspeicherressourcen verfügbar, um den Vorgang abzuschließen. |
|
Es wurden keine Schnittstellenstapeleinträge gefunden. |
|
Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Hinweise
Die GetInvertedIfStackTable-Funktion ist unter Windows Vista und höher definiert.
The
Die GetInvertedIfStackTable-Funktion listet die physischen und logischen Netzwerkschnittstellen auf einem Schnittstellenstapel auf einem lokalen System auf und gibt diese Informationen in umgekehrter Form in der MIB_INVERTEDIFSTACK_TABLE-Struktur zurück.
Schnittstellenstapeleinträge werden in einer MIB_INVERTEDIFSTACK_TABLE-Struktur im Puffer zurückgegeben, auf den der Table-Parameter verweist. Die MIB_INVERTEDIFSTACK_TABLE-Struktur enthält eine Schnittstellenstapeleintragsanzahl und ein Array von MIB_INVERTEDIFSTACK_ROW Strukturen für jeden Schnittstellenstapeleintrag.
Die Beziehung zwischen den Schnittstellen im Schnittstellenstapel besteht darin, dass sich die Schnittstelle mit dem Index im HigherLayerInterfaceIndex-Member der MIB_INVERTEDIFSTACK_ROW-Struktur direkt über der Schnittstelle mit index im LowerLayerInterfaceIndex-Element der MIB_INVERTEDIFSTACK_ROW-Struktur befindet.
Der Arbeitsspeicher wird von der GetInvertedIfStackTable-Funktion für die MIB_INVERTEDIFSTACK_TABLE-Struktur und die MIB_INVERTEDIFSTACK_ROW Einträge in dieser Struktur zugeordnet. 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_INVERTEDIFSTACK_TABLE Struktur, auf die der Table-Parameter verweist, eine Auffüllung für die Ausrichtung zwischen dem NumEntries-Element und dem ersten MIB_INVERTEDIFSTACK_ROW Arrayeintrag im Table-Element der MIB_INVERTEDIFSTACK_TABLE-Struktur enthalten kann. Zwischen den MIB_INVERTEDIFSTACK_ROW Arrayeinträgen kann auch ein Abstand für die Ausrichtung vorhanden sein. Bei jedem Zugriff auf einen MIB_INVERTEDIFSTACK_ROW 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 |