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-xxxx-xxxxxxxxxxxx}\”。
[out] lpszVolumePathNames
指向缓冲区的指针，该缓冲区接收驱动器号和装载的文件夹路径的列表。 列表是一个以 null 结尾的字符串数组，这些字符串以其他 NULL 字符结尾。 如果缓冲区不够大，无法容纳完整列表，则缓冲区会保留尽可能多的列表。
[in] cchBufferLength
lpszVolumePathNames 缓冲区的长度（以 TCHAR 为单位），包括所有 NULL 字符。
[out] lpcchReturnLength
如果调用成功，此参数是复制到 lpszVolumePathNames 缓冲区的TCHAR 数。 否则，此参数是保存完整列表所需的缓冲区大小（以 TCHAR 为单位）。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。 如果缓冲区不够大，无法容纳完整列表，则 错误代码ERROR_MORE_DATA ， 并且 lpcchReturnLength 参数接收所需的缓冲区大小。
注解
在 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 |