Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Funkce GetIfEntry2 načte informace pro zadané rozhraní v místním počítači.
Důležitý
Pro vývojáře ovladačů se doporučuje použít GetIfEntry2Ex s MibIfEntryNormalWithoutStatistics, aby se zabránilo zablokování při údržbě identifikátorů NDIS OID.
Syntax
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Parametry
-
řádek [in, out]
Ukazatel na MIB_IF_ROW2 strukturu, která při úspěšném vrácení obdrží informace o rozhraní v místním počítači. Na vstupu musí ovladač nastavit InterfaceLuid člen nebo InterfaceIndex člen struktury MIB_IF_ROW2 rozhraní pro načtení informací.
Návratová hodnota
GetIfEntry2 vrátí STATUS_SUCCESS, pokud je funkce úspěšná.
Pokud funkce selže, GetIfEntry2 vrátí jeden z následujících kódů chyb:
| Návratový kód | Popis |
|---|---|
| STATUS_INVALID_PARAMETER | Funkci byla předána neplatná hodnota parametru. Tato chyba se vrátí , pokud je v parametru řádku předán ukazatel null. |
| STATUS_NOT_FOUND | Zadané rozhraní nebylo nalezeno. Tato chyba se vrátí, pokud funkce nemůže najít síťové rozhraní určené InterfaceLuid nebo InterfaceIndex člen struktury MIB_IF_ROW2, na kterou odkazuje parametr řádek. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Na vstupu musí ovladač inicializovat alespoň InterfaceLuid nebo InterfaceIndex člen ve struktuře MIB_IF_ROW2, která je předána v řádku parametru. Členové se používají v pořadí, které je uvedeno dříve. Pokud je tedy zadán InterfaceLuid, použije se tento člen k určení rozhraní. Pokud nebyla nastavena žádná hodnota pro InterfaceLuid člen (hodnota tohoto členu byla nastavena na nulu), InterfaceIndex člen se použije k určení rozhraní.
Ve výstupu jsou vyplněna zbývající pole struktury MIB_IF_ROW2, na která odkazuje řádek parametru.