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 GetInvertedIfStackTable načte tabulku položek řádku zásobníku invertovaného síťového rozhraní, které určují relaci síťových rozhraní v zásobníku rozhraní.
Syntax
NETIOAPI_API GetInvertedIfStackTable(
_Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);
Parametry
-
tabulky [out]
Ukazatel na vyrovnávací paměť, která přijímá tabulku invertovaných položek řádků zásobníku rozhraní ve struktuře MIB_INVERTEDIFSTACK_TABLE.
Návratová hodnota
GetInvertedIfStackTable vrátí STATUS_SUCCESS, pokud bude funkce úspěšná.
Pokud funkce selže, GetInvertedIfStackTable 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 table předán ukazatel null. |
| STATUS_NOT_ENOUGH_MEMORY | K dokončení operace je k dispozici nedostatek prostředků paměti. |
| STATUS_NOT_FOUND | Nebyly nalezeny žádné položky zásobníku rozhraní. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Funkce GetInvertedIfStackTable vytvoří výčet fyzických a logických síťových rozhraní v zásobníku rozhraní v místním počítači a vrátí tyto informace v obrácené podobě ve struktuře MIB_INVERTEDIFSTACK_TABLE.
GetInvertedIfStackTable vrátí položky zásobníku rozhraní ve struktuře MIB_INVERTEDIFSTACK_TABLE ve vyrovnávací paměti, na kterou odkazuje parametr Table. Struktura MIB_INVERTEDIFSTACK_TABLE obsahuje počet položek zásobníku rozhraní a pole MIB_INVERTEDIFSTACK_ROW struktur pro každou položku zásobníku rozhraní.
Vztah mezi rozhraními v zásobníku rozhraní je, že rozhraní s indexem v HigherLayerInterfaceIndex člen struktury MIB_INVERTEDIFSTACK_ROW je bezprostředně nad rozhraním s indexem v LowerLayerInterfaceIndex člen MIB_INVERTEDIFSTACK_ROW struktury.
GetInvertedIfStackTable přidělí paměť pro strukturu MIB_INVERTEDIFSTACK_TABLE a položky MIB_INVERTEDIFSTACK_ROW v této struktuře. Pokud tyto vrácené struktury již nejsou požadovány, ovladač by měl uvolnit paměť voláním FreeMibTable.
Všimněte si, že vrácená MIB_INVERTEDIFSTACK_TABLE struktura, na kterou odkazuje parametr tabulka, může obsahovat odsazení pro zarovnání mezi členy NumEntries a první položkou pole MIB_INVERTEDIFSTACK_ROW v tabulce člen struktury MIB_INVERTEDIFSTACK_TABLE. Odsazení pro zarovnání může být také mezi položkami pole MIB_INVERTEDIFSTACK_ROW. Jakýkoli přístup k položce pole MIB_INVERTEDIFSTACK_ROW by měl předpokládat, že odsazení může existovat.