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 GetIfTable2 načte tabulku rozhraní MIB-II.
Syntax
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parametry
-
tabulky [out]
Ukazatel na vyrovnávací paměť, která přijímá tabulku rozhraní ve struktuře MIB_IF_TABLE2.
Návratová hodnota
GetIfTable2 vrátí STATUS_SUCCESS, pokud je funkce úspěšná.
Pokud funkce selže, GetIfTable2 vrátí jeden z následujících kódů chyb:
| Návratový kód | Popis |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | K dokončení operace je k dispozici nedostatek prostředků paměti. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Funkce GetIfTable2 vytvoří výčet logických a fyzických rozhraní v místním počítači a vrátí tyto informace ve struktuře MIB_IF_TABLE2.
Ovladač může použít podobnou funkci, GetIfTable2Ex, určit úroveň rozhraní, která se mají vrátit. Volání funkce GetIfTable2Ex s parametrem Level nastaveným na MibIfTableNormal načte stejné výsledky jako volání funkce GetIfTable2.
GetIfTable2 vrací rozhraní ve struktuře MIB_IF_TABLE2 ve vyrovnávací paměti, na kterou odkazuje parametr Table. Struktura MIB_IF_TABLE2 obsahuje počet rozhraní a pole MIB_IF_ROW2 struktur pro každé rozhraní. GetIfTable2 přidělí paměť pro strukturu MIB_IF_TABLE2 a položky MIB_IF_ROW2 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á struktura MIB_IF_TABLE2, že tabulka parametr může obsahovat odsazení pro zarovnání mezi NumEntries člen a první položku pole MIB_IF_ROW2 v Tabulce člen struktury MIB_IF_TABLE2. Odsazení pro zarovnání může být také mezi položkami pole MIB_IF_ROW2. Jakýkoli přístup k položce pole MIB_IF_ROW2 by měl předpokládat, že odsazení může existovat.