GetInvertedIfStackTable 関数 (netioapi.h)

[アーティクル]
08/25/2023

GetInvertedIfStackTable 関数は、インターフェイススタック上のネットワークインターフェイスのリレーションシップを指定する、反転されたネットワークインターフェイススタック行エントリのテーブルを取得します。

構文

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetInvertedIfStackTable(
  [out] PMIB_INVERTEDIFSTACK_TABLE *Table
);

パラメーター

[out] Table

MIB_INVERTEDIFSTACK_TABLE構造体の反転インターフェイススタック行エントリのテーブルを受け取るバッファーへのポインター。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

リターンコード	説明
ERROR_INVALID_PARAMETER	無効なパラメーターが関数に渡されました。このエラーは、Table パラメーターに NULL ポインターが渡された場合に返されます。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するために使用できるメモリリソースが不足しています。
ERROR_NOT_FOUND	インターフェイススタックエントリが見つかりませんでした。
その他	FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。

注釈

GetInvertedIfStackTable 関数は、Windows Vista 以降で定義されています。

次に、
GetInvertedIfStackTable 関数は、ローカルシステム上のインターフェイススタック上の物理ネットワークインターフェイスと論理ネットワークインターフェイスを列挙し、この情報を MIB_INVERTEDIFSTACK_TABLE 構造の反転形式で返します。

インターフェイススタックエントリは、Table パラメーターによって指されるバッファー内のMIB_INVERTEDIFSTACK_TABLE構造体で返されます。 MIB_INVERTEDIFSTACK_TABLE構造体には、インターフェイススタックエントリ数と、各インターフェイススタックエントリのMIB_INVERTEDIFSTACK_ROW構造体の配列が含まれています。

インターフェイススタック内のインターフェイス間の関係は、MIB_INVERTEDIFSTACK_ROW 構造体の HigherLayerInterfaceIndex メンバーのインデックスを持つインターフェイスが、MIB_INVERTEDIFSTACK_ROW構造体の LowerLayerInterfaceIndex メンバーのインデックスを持つインターフェイスのすぐ上にあるということです。

メモリは、 getInvertedIfStackTable 関数によって、MIB_INVERTEDIFSTACK_TABLE 構造体と、この構造体内の MIB_INVERTEDIFSTACK_ROW エントリに割り当てられます。これらの返される構造体が不要になったら、 FreeMibTable を呼び出してメモリを解放します。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	netioapi.h (Iphlpapi.h を含む)
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll