次の方法で共有

GetIfEntry2 関数

  • [アーティクル]

GetIfEntry2 関数は、ローカル コンピューター上の指定されたインターフェイスの情報を取得します。

大事な

ドライバー開発者の場合は、NDIS OID をサービスするときにデッドロックを回避するために、可能な場合は MibIfEntryNormalWithoutStatistics で GetIfEntry2Ex を使用することをお勧めします。

構文

NETIOAPI_API GetIfEntry2(
  _Inout_ PMIB_IF_ROW2 Row
);

パラメーター

  • 行 [入力、出力]
    正常に戻った場合にローカル コンピューター上のインターフェイスの情報を受け取る MIB_IF_ROW2 構造体へのポインター。 入力時に、ドライバーは、InterfaceLuid メンバー、またはMIB_IF_ROW2構造体の InterfaceIndex メンバーをインターフェイスに設定して情報を取得する必要があります。

戻り値

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

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

リターン コード 形容
STATUS_INVALID_PARAMETER

無効なパラメーターが関数に渡されました。 このエラーは、NULL ポインターが Row パラメーターで渡された場合に返されます。
STATUS_NOT_FOUND

指定されたインターフェイスが見つかりませんでした。 このエラーは、InterfaceLuid で指定されたネットワーク インターフェイスが関数で見つからない場合、または Row パラメーターが指す MIB_IF_ROW2 構造体の InterfaceIndex メンバーを 場合に返されます。
その他の

FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。

備考

入力時に、ドライバーは、Row パラメーターで渡される MIB_IF_ROW2 構造体の InterfaceLuid または InterfaceIndex メンバーを初期化する必要があります。 メンバーは、前に示した順序で使用されます。 そのため、InterfaceLuid 指定した場合、このメンバーを使用してインターフェイスが決定されます。 InterfaceLuid メンバーに値が設定されていない場合 (このメンバーの値が 0 に設定されました)、インターフェイスを決定するために、InterfaceIndex メンバーが次に使用されます。

出力時に、Row パラメーターが指すMIB_IF_ROW2構造体の残りのフィールドが入力されます。

必要条件

ターゲット プラットフォーム

 ユニバーサル

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダ

 Netioapi.h (Netioapi.h を含む)

図書館

 Netio.lib

IRQL

< DISPATCH_LEVEL

関連項目

GetIfTable2をする

GetIfTable2Exの

MIB_IF_ROW2

MIB_IF_TABLE2