GetIfTable2 függvény

A GetIfTable2 függvény lekéri a MIB-II interfésztáblát.

Szintaxis

NETIOAPI_API GetIfTable2(
  _Out_ PMIB_IF_TABLE2 *Table
);

Paraméterek

• 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

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

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

Kód visszaadása	Leírás
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 GetIfTable2 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ő a getIfTable2Exhasonló függvényt használhatja a visszaadni kívánt felületek szintjének megadásához. 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.

GetIfTable2 a Table paraméter által a pufferben lévő MIB_IF_TABLE2 struktúrában lévő interfészeket adja vissza. 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 memóriát foglal le a MIB_IF_TABLE2 struktúrához és a MIB_IF_ROW2 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_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

GetIfTable2Ex

MIB_IF_TABLE2

MIB_IF_ROW2