关闭指定的卷搜索句柄。 FindFirstVolume 和 FindNextVolume 函数使用此搜索句柄来查找卷。
语法
BOOL FindVolumeClose(
[in] HANDLE hFindVolume
);
参数
[in] hFindVolume
要关闭的卷搜索句柄。 此句柄必须以前由 FindFirstVolume 函数打开。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
调用 FindVolumeClose 函数后，句柄 hFindVolume 不能用于对 FindNextVolume 或 FindVolumeClose 的后续调用。
在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。
| 技术 | 支持 |
|---|---|
| 服务器消息块 (SMB) 3.0 协议 | 否 |
| SMB 3.0 透明故障转移 (TFO) | 否 |
| 具有横向扩展文件共享的 SMB 3.0 (SO) | 否 |
| 群集共享卷文件系统 (CSV) | 是 |
| 弹性文件系统 (ReFS) | 是 |
SMB 不支持卷管理功能。
示例
有关示例，请参阅 显示卷路径。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | fileapi.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |