GetIfStackTable függvény

A GetIfStackTable függvény lekéri a hálózati adapterek sorbejegyzéseinek táblázatát, amelyek meghatározzák a hálózati adapterek kapcsolatát egy adapterveremen.

Szintaxis

NETIOAPI_API GetIfStackTable(
  _Out_ PMIB_IFSTACK_TABLE *Table
);

Paraméterek

• tábla [ki]
  Egy olyan pufferre mutató mutató, amely egy MIB_IFSTACK_TABLE struktúrában fogadja az illesztő veremsor bejegyzéseit tartalmazó táblát.

Visszaadott érték

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

Ha a függvény meghiúsul, GetIfStackTable 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 GetIfStackTable 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 egy MIB_IFSTACK_TABLE struktúrában adja vissza.

Az illesztő verembejegyzések egy MIB_IFSTACK_TABLE struktúrában jelennek meg abban a pufferben, amelyre a Tábla paraméter mutat. A MIB_IFSTACK_TABLE struktúra tartalmazza az interfész verembejegyzéseinek számát és az egyes illesztő verembejegyzésekhez tartozó MIB_IFSTACK_ROW struktúrák tömbét.

Az illesztő verem felületei közötti kapcsolat az, hogy a HigherLayerInterfaceIndex MIB_IFSTACK_ROW struktúrájának indexét tartalmazó felület közvetlenül a LowerLayerInterfaceIndex MIB_IFSTACK_ROW struktúrájának tagja fölött van.

A memóriát a GetIfStackTable függvény foglalja le a MIB_IFSTACK_TABLE struktúrához és a MIB_IFSTACK_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_IFSTACK_TABLE struktúra, amelyet a Tábla paraméter a NumEntries tag és a Tábla MIB_IFSTACK_TABLE tag első MIB_IFSTACK_ROW tömbbejegyzése közötti igazításhoz tartalmazhat. Előfordulhat, hogy a MIB_IFSTACK_ROW tömbbejegyzések között is van párnázás az igazításhoz. Egy MIB_IFSTACK_ROW tömbbejegyzéshez való hozzáférés feltételezi, hogy a kitöltés létezhet.

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

GetIfTable2

GetInvertedIfStackTable

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