通过

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

另请参阅

装载的文件夹

卷管理功能