FindVolumeClose 関数 (fileapi.h)

指定したボリューム検索ハンドルを閉じます。 FindFirstVolume 関数と FindNextVolume 関数は、この検索ハンドルを使用してボリュームを検索します。

構文

BOOL FindVolumeClose(
  [in] HANDLE hFindVolume
);

パラメーター

[in] hFindVolume

閉じるボリューム検索ハンドル。 このハンドルは、 FindFirstVolume 関数によって以前に開かれている必要があります。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

FindVolumeClose 関数を呼び出した後、FindNextVolume または FindVolumeClose の後続の呼び出しでは、ハンドル hFindVolume を使用できません。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

テクノロジ サポートされています
サーバー メッセージ ブロック (SMB) 3.0 プロトコル いいえ
SMB 3.0 Transparent Failover (TFO) いいえ
スケールアウト ファイル共有 (SO) を使う SMB 3.0 いいえ
クラスターの共有ボリューム ファイル システム (CsvFS) はい
Resilient File System (ReFS) はい
 

SMB では、ボリューム管理機能はサポートされていません。

例については、「 ボリューム パスの表示」を参照してください。

要件

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

関連項目

FindFirstVolume

FindNextVolume

マウントされたフォルダー

ボリューム管理の関数