通过

GetVirtualDiskPhysicalPath 函数 （virtdisk.h）

  • 项目

检索包含虚拟硬盘（VHD）或 CD 或 DVD 映像文件（ISO）的物理设备对象的路径。

语法

DWORD GetVirtualDiskPhysicalPath(
  [in]            HANDLE VirtualDiskHandle,
  [in, out]       PULONG DiskPathSizeInBytes,
  [out, optional] PWSTR  DiskPath
);

参数

[in] VirtualDiskHandle

打开的虚拟磁盘的句柄，必须使用 VIRTUAL_DISK_ACCESS_GET_INFO 标志打开。 有关如何打开虚拟磁盘的信息，请参阅 OpenVirtualDisk 函数。

[in, out] DiskPathSizeInBytes

DiskPath 参数指向的缓冲区的大小（以字节为单位）。

[out, optional] DiskPath

用于接收包含虚拟磁盘的物理磁盘设备的路径的目标缓冲区。

返回值

请求的状态。

如果函数成功，则返回值 ERROR_SUCCESS，DiskPath 参数包含指向已填充字符串的指针。

如果函数失败，则返回值为错误代码，并且未定义由 DiskPath 参数引用的缓冲区内容的值。 有关详细信息，请参阅 系统错误代码。

言论

要使 GetVirtualDiskPhysicalPath 函数成功，必须附加由 VirtualDiskHandle 参数引用的虚拟磁盘，物理磁盘对象必须由系统定位，DiskPath 参数必须引用足够大的缓冲区来保存生成的路径。 此路径采用 \\.\PhysicalDriveX，其中 X 是一个整数，表示调用方系统上物理磁盘的特定枚举。

Windows 8 和 Windows Server 2012 之前不支持 CD 和 DVD 映像文件（ISO）。

要求

要求 价值
最低支持的客户端 Windows 7
支持的最低服务器 Windows Server 2008 R2
目标平台 窗户
标头 virtdisk.h
库 VirtDisk.lib
DLL VirtDisk.dll

另请参阅

关于 VHD 的

VHD 参考