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) 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

另请参阅

FindFirstVolume

FindVolumeClose

装载的文件夹

卷管理函数