次の方法で共有

FilterInstanceFindNext 関数 (fltuser.h)

  • [アーティクル]

FilterInstanceFindNext 関数は、FilterInstanceFindFirst の呼び出しによって開始されたミニフィルター ドライバー インスタンスの検索を続行します。

構文

HRESULT FilterInstanceFindNext(
  [in]  HANDLE                     hFilterInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

パラメーター

[in] hFilterInstanceFind

FilterInstanceFindFirst の以前の呼び出しによって返されるミニフィルター インスタンス検索ハンドル。

[in] dwInformationClass

返されるインスタンス情報構造体の型。 このパラメーターには、次のいずれかの値が含まれている必要があります。

値 意味
InstanceBasicInformation インスタンスの INSTANCE_BASIC_INFORMATION 構造体を返します。
InstanceFullInformation インスタンスの INSTANCE_FULL_INFORMATION 構造体を返します。
InstancePartialInformation インスタンスの INSTANCE_PARTIAL_INFORMATION 構造体を返します。
InstanceAggregateStandardInformation インスタンスの INSTANCE_AGGREGATE_STANDARD_INFORMATION 構造体を返します。 構造体の LegacyFilter 部分は使用されません。 この構造は、Windows Vista 以降で使用できます。

[out] lpBuffer

要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。 バッファーで返される情報の型は、 dwInformationClass パラメーターによって定義されます。

[in] dwBufferSize

lpBuffer パラメーターが指すバッファーのサイズ (バイト単位)。 呼び出し元は、指定された dwInformationClass に従ってこのパラメーターを設定する必要があります。

[out] lpBytesReturned

FilterInstanceFindNext の呼び出しが成功した場合に lpBuffer が指すバッファーで返されるバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは必須であり、 NULL にすることはできません。

戻り値

FilterInstanceFindNext は 、成功した場合にS_OKを返します。 それ以外の場合は、次のいずれかの HRESULT エラー値を返します。

リターン コード 説明
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 lpBuffer が指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 この値が返されると、 lpBytesReturned には、指定された dwInformationClass 構造体に必要なバッファーのサイズ (バイト単位) が含まれます。
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)
 dwInformationClass パラメーターに無効な値が指定されました。 たとえば、Windows Vista より前のオペレーティング システムに InstanceAggregateStandardInformation が指定されている場合、 FilterInstanceFindNext はこの HRESULT 値を返します。
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
 この HRESULT 値は、ミニフィルターの一意のインスタンスがなくなった場合に返されます。

解説

FilterInstanceFindFirst を呼び出して検索ハンドルが確立されたら、FilterInstanceFindNext を呼び出して、FilterInstanceFindFirst の呼び出しで指定されたミニフィルターの他のインスタンスを検索します。

FilterInstanceFindNext は 、呼び出しごとに 1 つのインスタンスを検索します。

要件

   
対象プラットフォーム ユニバーサル
Header fltuser.h (FltUser.h を含む)
Library FltLib.lib
[DLL] FltLib.dll

関連項目

FilterInstanceFindClose

FilterInstanceFindFirst

INSTANCE_AGGREGATE_STANDARD_INFORMATION

INSTANCE_BASIC_INFORMATION

INSTANCE_FULL_INFORMATION

INSTANCE_PARTIAL_INFORMATION