次の方法で共有

FilterVolumeFindFirst 関数 (fltuser.h)

  • [アーティクル]

FilterVolumeFindFirst 関数は、ボリュームに関する情報を返します。

構文

HRESULT FilterVolumeFindFirst(
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned,
  [out] PHANDLE                         lpVolumeFind
);

パラメーター

[in] dwInformationClass

要求された情報の種類。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
FilterVolumeBasicInformation lpBuffer パラメーターが指すバッファーは、ボリュームのFILTER_VOLUME_BASIC_INFORMATION構造体を受け取ります。
FilterVolumeStandardInformation lpBuffer パラメーターが指すバッファーは、ボリュームのFILTER_VOLUME_STANDARD_INFORMATION構造体を受け取ります。 この構造は、Windows Vista 以降で使用できます。

[out] lpBuffer

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

[in] dwBufferSize

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

[out] lpBytesReturned

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

[out] lpVolumeFind

FilterVolumeFindFirst の呼び出しが成功した場合にミニフィルターの検索ハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。それ以外の場合は、INVALID_HANDLE_VALUEを受け取ります。 この検索ハンドルは、 FilterVolumeFindNext と FilterVolumeFindClose の後続の呼び出しで使用できます。

戻り値

FilterVolumeFindFirst は、ボリュームに関する情報が正常に返された場合にS_OKを返します。 それ以外の場合は、次のいずれかの HRESULT エラー値を返します。

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

解説

この FilterVolumeFindFirst 関数は、フィルター マネージャーで認識されているボリュームのスキャンを開始するために使用されます。

FilterVolumeFindFirst は検索ハンドルを開き、フィルター マネージャーに認識されているボリュームの一覧で最初に見つかったボリュームに関する情報を返します。 検索ハンドルが確立されたら、 FilterVolumeFindNext 関数を使用して、フィルター マネージャーの一覧で他のボリュームを検索します。 検索ハンドルが不要になったら、 FilterVolumeFindClose を呼び出して閉じます。

FilterVolumeFindFirst と FilterVolumeFindNext を使用してフィルター マネージャーに認識されているボリュームの一覧を列挙する場合、リスト内の複数のボリュームの名前が同じである可能性があることに注意してください。 詳細については、「 重複するボリューム名を持つボリューム列挙について」を参照してください。

要件

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

関連項目

FILTER_VOLUME_BASIC_INFORMATION

FILTER_VOLUME_STANDARD_INFORMATION

FilterVolumeFindClose

FilterVolumeFindNext