Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |