GetVolumeNameForVolumeMountPointW 函数 (fileapi.h)

  • 项目

检索与指定卷装入点（驱动器号、卷 GUID 路径或装载的文件夹）关联的卷的卷 GUID 路径。

语法

BOOL GetVolumeNameForVolumeMountPointW(
  [in]  LPCWSTR lpszVolumeMountPoint,
  [out] LPWSTR  lpszVolumeName,
  [in]  DWORD   cchBufferLength
);

参数

[in] lpszVolumeMountPoint

指向包含装载文件夹路径的字符串的指针， (例如“Y：\MountX\”) 或驱动器号 (例如“X：\”) 。 字符串必须以尾随反斜杠结尾 ('\') 。

[out] lpszVolumeName

指向接收卷 GUID 路径的字符串的指针。 此路径的格式为“\\？\Volume{GUID}\”，其中 GUID 是标识卷的 GUID 。 如果卷有多个卷 GUID 路径，则仅返回装载管理器缓存中的第一个路径。

[in] cchBufferLength

输出缓冲区的长度（以 TCHAR 为单位）。 要容纳最大卷 GUID 路径的合理缓冲区大小为 50 个字符。

返回值

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

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

使用 GetVolumeNameForVolumeMountPoint 获取卷 GUID 路径，以便与需要卷 GUID 路径作为输入参数的函数（如 SetVolumeMountPoint 和 FindFirstVolumeMountPoint）配合使用。 有关卷 GUID 路径的详细信息，请参阅 命名卷。

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

技术 支持
服务器消息块 (SMB) 3.0 协议 否
SMB 3.0 透明故障转移 (TFO) 否
具有横向扩展文件共享的 SMB 3.0 (SO) 否
群集共享卷文件系统 (CSV) 是
弹性文件系统 (ReFS) 否
 

SMB 不支持卷管理功能。

ReFS 卷不支持装入点。

要求

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

另请参阅

DeleteVolumeMountPoint

GetVolumePathName

装载的文件夹

SetVolumeMountPoint

卷管理函数