Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A GetIfEntry2 függvény beolvassa a megadott felület adatait egy helyi számítógépen.
Fontos
Az illesztőprogram-fejlesztők számára ajánlott a GetIfEntry2Ex használata a MibIfEntryNormalWithoutStatistics használatával, ha lehetséges, annak érdekében, hogy elkerülhető legyen a holtpont az NDIS-azonosítók karbantartása során.
Szintaxis
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Paraméterek
-
sor [be, ki]
Egy MIB_IF_ROW2 szerkezetre mutató mutató, amely sikeres visszatérés esetén információt kap a helyi számítógépen található felületről. Bemenetkor az illesztőnek be kell állítania a InterfaceLuid tagot vagy a InterfaceIndex tagot a MIB_IF_ROW2 struktúrában az interfészre az információk lekéréséhez.
Visszaadott érték
GetIfEntry2 a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.
Ha a függvény meghiúsul, GetIfEntry2 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 NULL mutatót ad át a Sor paraméterben. |
| STATUS_NOT_FOUND | A megadott felület nem található. Ez a hiba akkor jelenik meg, ha a függvény nem találja a InterfaceLuid vagy InterfaceIndex által megadott hálózati adaptert annak a MIB_IF_ROW2 struktúrának, amelyre a sor paraméter mutat. |
| Egyéb | A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét. |
Megjegyzések
Bemenetkor az illesztőnek inicializálnia kell legalább a InterfaceLuid vagy InterfaceIndex tagot a Sor paraméterben átadott MIB_IF_ROW2 struktúrában. A tagok a korábban felsorolt sorrendben lesznek használva. Ha tehát InterfaceLuid van megadva, ez a tag határozza meg a felületet. Ha a InterfaceLuid taghoz nem állított be értéket (ennek a tagnak az értéke nulla volt), a InterfaceIndex tagot használja a rendszer a felület meghatározásához.
Kimenet esetén a MIB_IF_ROW2 struktúra fennmaradó mezői, amelyeket a Sor paraméterpont kitölt.
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 |