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 |