GetIfTable2Ex függvény

A GetIfTable2Ex függvény lekéri a MIB-II interfésztáblát, a lekérendő felületi információk szintje alapján.

Szintaxis

NETIOAPI_API GetIfTable2Ex(
  _In_  MIB_IF_TABLE_LEVEL Level,
  _Out_ PMIB_IF_TABLE2     *Table
);

Paraméterek

• szint [in]
  A lekérendő felületi információk szintje. Ez a paraméter a MIB_IF_TABLE_LEVEL enumerálás egyik értéke lehet.

• tábla [ki]
  Egy olyan pufferre mutató mutató, amely egy MIB_IF_TABLE2 struktúrában fogadja az illesztőtáblát.

Visszaadott érték

GetIfTable2Ex a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.

Ha a függvény meghiúsul, GetIfTable2Ex 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 a level paraméterben egy érvénytelen értéket ad át.
STATUS_NOT_ENOUGH_MEMORY	A művelet végrehajtásához nincs elegendő memóriaerőforrás.
Egyéb	A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A GetIfTable2Ex függvény számba adja a helyi számítógép logikai és fizikai adaptereit, és ezt az információt egy MIB_IF_TABLE2 struktúrában adja vissza.

Az illesztő használhat egy hasonló függvényt, GetIfTable2, hogy lekérje az illesztőket, de GetIfTable2 nem teszi lehetővé az illesztők visszatérési szintjének beállítását. A GetIfTable2Ex függvény hívása a Szint paraméterrel, amely MibIfTableNormal a GetIfTable2 függvény meghívásával azonos eredményeket kéri le.

GetIfTable2Ex egy MIB_IF_TABLE2 struktúrában lévő interfészeket ad vissza abban a pufferben, amelyre a Tábla paraméter mutat. A MIB_IF_TABLE2-struktúra az egyes interfészek adapterszámát és MIB_IF_ROW2 struktúráinak tömbét tartalmazza. GetIfTable2 a MIB_IF_TABLE2 struktúrához és a szerkezet MIB_IF_ROW2 bejegyzéseihez rendel mmory-t. 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.

A rendszer az szint paraméter egyik lehetséges értékéhez adja vissza az összes illesztőt, beleértve az NDIS köztes illesztőillesztőket és az NDIS szűrőillesztő adaptereket is. A Level paraméter beállítása befolyásolja a MIB_IF_ROW2 struktúra statisztikáit és állapottagjait a MIB_IF_TABLE2 struktúrában, amelyekre az interfész Tábla paramétere mutat. Egy hálózati adapter (NIC) például NDIS miniportillesztővel rendelkezik. NDIS köztes illesztőprogram telepíthető a felső szintű protokollillesztők és az NDIS miniportillesztők közötti interfészhez. Egy NDIS-szűrőillesztő csatolható az NDIS köztes illesztőprogramhoz. Tegyük fel, hogy a hálózati adapter a MediaConnectState MIB_IF_ROW2 tagját jelenti MediaConnectStateConnected, de az NDIS szűrőillesztő módosítja az állapotot, és MediaConnectStateDisconnectedként jelenti az állapotot. Ha a rendszer lekérdezi a felület adatait MibIfTableNormal level paraméterrel, a rendszer a szűrőverem tetején lévő állapotot (MediaConnectStateDisconnected) jelenti. Ha a rendszer lekérdezi az interfészt a MibIfTableRaw paraméterrel, a rendszer a felület szintjén lévő állapotot (MediaConnectStateConnected) adja vissza.

Vegye figyelembe, hogy a visszaadott MIB_IF_TABLE2 struktúra, amelyet a Tábla paraméter mutat, a NumEntries tag és a Tábla MIB_IF_TABLE2 szerkezet első MIB_IF_ROW2 tömbbejegyzése közötti igazításhoz használható kitöltést tartalmazhat. Előfordulhat, hogy a MIB_IF_ROW2 tömbbejegyzések között is van párnázás az igazításhoz. Egy MIB_IF_ROW2 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

GetIfTable2

MIB_IF_TABLE_LEVEL

MIB_IF_TABLE2

MIB_IF_ROW2