检索计算机上的卷的名称。 FindFirstVolume 用于开始扫描计算机的卷。
语法
HANDLE FindFirstVolumeW(
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
参数
[out] lpszVolumeName
指向缓冲区的指针，该缓冲区接收以 null 结尾的字符串，该字符串指定找到的第一个卷的卷 GUID 路径。
[in] cchBufferLength
要接收卷 GUID 路径的缓冲区长度（以 TCHAR 为单位）。
返回值
如果函数成功，则返回值是后续调用 FindNextVolume 和 FindVolumeClose 函数中使用的搜索句柄。
如果函数找不到任何卷，则返回值为 INVALID_HANDLE_VALUE 错误代码。 要获得更多的错误信息，请调用 GetLastError。
注解
FindFirstVolume 函数打开卷搜索句柄，并返回有关在计算机上找到的第一个卷的信息。 建立搜索句柄后，可以使用 FindNextVolume 函数搜索其他卷。 如果不再需要搜索句柄，请使用 FindVolumeClose 函数将其关闭。
不应假定这些函数返回的卷的顺序与计算机上的卷顺序之间存在任何关联。 具体地讲，就是不要假设 BIOS（如果有）或磁盘管理员分配的卷顺序和驱动器号之间存在任何相关性。
在 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 |