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之前，不支持 (ISO) 的 CD 和 DVD 映像文件。

要求

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

另请参阅

关于 VHD

VHD 参考