FindFirstVolumeW 函数 (fileapi.h)

检索计算机上的卷的名称。 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 不支持卷管理功能。

有关示例，请参阅显示卷路径。