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 エラー値が返されます。
| リターン コード | 形容 |
|---|---|
|
lpBuffer 指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 この値が返されると、lpBytesReturned には、指定された dwInformationClass 構造体に必要なバッファーのサイズ (バイト単位) が含まれます。 |
|
dwInformationClass パラメーターに無効な値が指定されました。 たとえば、Windows Vista より前のオペレーティング システム InstanceAggregateStandardInformation が指定されている場合、FilterInstanceFindNext はこの HRESULT 値を返します。 |
|
この HRESULT 値は、ミニフィルターの一意のインスタンスがなくなった場合に返されます。 |
備考
FilterInstanceFindFirst 呼び出して検索ハンドルを確立した後、FilterInstanceFindNext 呼び出して、FilterInstanceFindFirst の呼び出しで指定されたミニフィルターの他のインスタンス検索します。
FilterInstanceFindNext は、呼び出しごとに 1 つのインスタンスを検索します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fltuser.h (FltUser.h を含む) |
| ライブラリ | FltLib.lib |
| DLL | FltLib.dll |