findNextVolumeW 函数 (fileapi.h)

继续通过调用 FindFirstVolume 函数启动的卷搜索。 FindNextVolume 为每个调用查找一个卷。

语法

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

[in] hFindVolume

上一次调用 FindFirstVolume 函数返回的卷搜索句柄。

[out] lpszVolumeName

指向接收找到的卷 GUID 路径的字符串的指针。

[in] cchBufferLength

接收卷 GUID 路径的缓冲区的长度（以 TCHAR 为单位）。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。如果找不到匹配的文件， GetLastError 函数将返回 ERROR_NO_MORE_FILES 错误代码。在这种情况下，请使用 FindVolumeClose 函数关闭搜索。

通过调用 FindFirstVolume 建立搜索句柄后，可以使用 FindNextVolume 函数搜索其他卷。

不应假设这些函数返回的卷的顺序与计算机上的卷顺序之间存在任何关联。具体地讲，就是不要假设 BIOS（如果有）或磁盘管理员分配的卷顺序和驱动器号之间存在任何相关性。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。

SMB 不支持卷管理功能。

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