GetInvertedIfStackTable függvény

A GetInvertedIfStackTable függvény beolvassa az invertált hálózati adapter veremsor-bejegyzéseit tartalmazó táblázatot, amely meghatározza az adapterverem hálózati adaptereinek kapcsolatát.

Szintaxis

NETIOAPI_API GetInvertedIfStackTable(
  _Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);

Paraméterek

  • tábla [ki]
    Egy olyan pufferre mutató mutató, amely egy MIB_INVERTEDIFSTACK_TABLE struktúrában lévő fordított illesztői veremsorbejegyzések tábláját fogadja.

Visszaadott érték

GetInvertedIfStackTable STATUS_SUCCESS ad vissza, ha a függvény sikeres.

Ha a függvény meghiúsul, GetInvertedIfStackTable a következő hibakódok egyikét adja vissza:

Kód visszaadása Leírás
STATUS_INVALID_PARAMETER

Érvénytelen paraméter lett átadva a függvénynek. Ez a hiba akkor jelenik meg, ha egy NULL mutatót ad át a Tábla paraméterben.

STATUS_NOT_ENOUGH_MEMORY

A művelet végrehajtásához nincs elegendő memóriaerőforrás.

STATUS_NOT_FOUND

Nem található felületi verembejegyzés.

Egyéb

A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A GetInvertedIfStackTable függvény számba adja a helyi számítógépen lévő adapterverem fizikai és logikai hálózati adaptereit, és ezt az információt fordított formában adja vissza a MIB_INVERTEDIFSTACK_TABLE struktúrában.

GetInvertedIfStackTable a Table paraméter által hivatkozott pufferben lévő MIB_INVERTEDIFSTACK_TABLE szerkezet felületi verembejegyzéseit adja vissza. A MIB_INVERTEDIFSTACK_TABLE struktúra tartalmazza az interfész verembejegyzéseinek számát és az egyes illesztő verembejegyzések MIB_INVERTEDIFSTACK_ROW struktúráinak tömbét.

Az illesztőverem illesztői közötti kapcsolat az, hogy a HigherLayerInterfaceIndex MIB_INVERTEDIFSTACK_ROW struktúrájának indexét tartalmazó felület közvetlenül a LowerLayerInterfaceIndex MIB_INVERTEDIFSTACK_ROW struktúrájának tagja indexével rendelkező felület felett van.

GetInvertedIfStackTable lefoglalja a memóriát a MIB_INVERTEDIFSTACK_TABLE struktúrához és a MIB_INVERTEDIFSTACK_ROW bejegyzéseihez ebben a struktúrában. Ha ezekre a visszaadott struktúrákra már nincs szükség, az illesztőprogramnak szabadíthatja fel a memóriát FreeMibTablemeghívásával.

Vegye figyelembe, hogy a visszaadott MIB_INVERTEDIFSTACK_TABLE struktúra, amelyet a Tábla paraméter a NumEntries tag és a Tábla MIB_INVERTEDIFSTACK_TABLE tag első MIB_INVERTEDIFSTACK_ROW tömbbejegyzése közötti igazításhoz tartalmazhat. Előfordulhat, hogy a MIB_INVERTEDIFSTACK_ROW tömbbejegyzések között is van párnázás az igazításhoz. Egy MIB_INVERTEDIFSTACK_ROW tömbbejegyzéshez való hozzáférés feltételezi, hogy létezik párnázás.

Követelmények

Célplatform

Univerzális

Verzió

Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.

Fejléc

Netioapi.h (netioapi.h)

Könyvtár

Netio.lib

IRQL

< DISPATCH_LEVEL

Lásd még:

FreeMibTable

GetIfEntry2

GetIfStackTable

GetIfTable2

GetIpInterfaceEntry

InitializeIpInterfaceEntry

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange

SetIpInterfaceEntry