GetIfTable2 関数

GetIfTable2 関数は、MIB-II インターフェイス テーブルを取得します。

構文

NETIOAPI_API GetIfTable2(
  _Out_ PMIB_IF_TABLE2 *Table
);

パラメーター

• テーブル [out]
  MIB_IF_TABLE2 構造体内のインターフェイスのテーブルを受け取るバッファーへのポインター。

戻り値

GetIfTable2 は、関数が成功した場合にSTATUS_SUCCESSを返します。

関数が失敗した場合、GetIfTable2 は次のいずれかのエラー コードを返します。

備考

GetIfTable2 関数は、ローカル コンピューター上の論理インターフェイスと物理インターフェイスを列挙し、この情報を MIB_IF_TABLE2 構造体で返します。

ドライバーは、GetIfTable2Ex同様の関数を使用して、返すインターフェイスのレベルを指定できます。 Level パラメーターを MibIfTableNormal に設定した GetIfTable2Ex 関数の呼び出しは、GetIfTable2 関数を呼び出すのと同じ結果を取得します。

GetIfTable2 は、Table パラメーターが指すバッファー内のMIB_IF_TABLE2構造体内のインターフェイスを返します。 MIB_IF_TABLE2構造体には、インターフェイス数と、各インターフェイスの MIB_IF_ROW2 構造体の配列が含まれています。 GetIfTable2 は、MIB_IF_TABLE2構造体と、この構造体のMIB_IF_ROW2 エントリにメモリを割り当てます。 これらの返された構造体が不要になったら、FreeMibTableを呼び出して、ドライバーメモリを解放する必要があります。

Table パラメーターが指す返されるMIB_IF_TABLE2構造体には、NumEntries メンバーと、MIB_IF_TABLE2構造体の Table メンバー内の最初のMIB_IF_ROW2配列エントリとの間の配置のためのパディングが含まれている可能性があることに注意してください。 配置のためのパディングは、MIB_IF_ROW2配列エントリ間にも存在する可能性があります。 MIB_IF_ROW2配列エントリへのアクセスは、パディングが存在する可能性があることを前提とする必要があります。

必要条件

関連項目

FreeMibTableをする

GetIfTable2Exの

MIB_IF_TABLE2

MIB_IF_ROW2