GetVolumePathNamesForVolumeNameW 函数 (fileapi.h)

检索指定卷的驱动器号和装载的文件夹路径的列表。

语法

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

参数

[in] lpszVolumeName

卷 GUID 卷的路径。 卷 GUID 路径的格式为“\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxxxx}\”。

[out] lpszVolumePathNames

指向接收驱动器号和已装载文件夹路径列表的缓冲区的指针。 该列表是以 null 结尾的字符串数组,由其他 NULL 字符终止。 如果缓冲区不够大,无法保存完整列表,则缓冲区将尽可能多地保存该列表。

[in] cchBufferLength

WCHAr中 lpszVolumePathNames 缓冲区的长度,包括所有 NULL 字符。

[out] lpcchReturnLength

如果调用成功,此参数是复制到 lpszVolumePathNames 缓冲区 WCHAR 的数目。 否则,此参数是保存完整列表所需的缓冲区大小,WCHAR。

返回值

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

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError。 如果缓冲区不够大以容纳完整列表,则错误代码 ERROR_MORE_DATA,lpcchReturnLength 参数接收所需的缓冲区大小。

言论

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

科技 支持
服务器消息块 (SMB) 3.0 协议 不
SMB 3.0 透明故障转移 (TFO) 不
具有横向扩展文件共享的 SMB 3.0 (SO) 不
群集共享卷文件系统 (CsvFS) 是的
可复原文件系统 (ReFS) 是的
 

SMB 不支持卷管理功能。

例子

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

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 fileapi.h (包括 Windows.h)
库 Kernel32.lib
DLL Kernel32.dll

另请参阅

装载的文件夹

卷管理功能