SetVirtualDiskInformation 函数 (virtdisk.h)

设置有关虚拟硬盘的信息 (VHD) 。

语法

DWORD SetVirtualDiskInformation(
  [in] HANDLE                 VirtualDiskHandle,
  [in] PSET_VIRTUAL_DISK_INFO VirtualDiskInfo
);

[in] VirtualDiskHandle

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

[in] VirtualDiskInfo

指向有效 SET_VIRTUAL_DISK_INFO 结构的指针。

请求的状态。

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值为错误代码。有关详细信息，请参阅系统错误代码。

如果请求设置 ParentFilePath 成员，但系统无法解析提供的路径，SetVirtualDiskInformation 函数将失败。

设置父信息还会导致更新子级的父 GUID 和时间戳字段。

此操作正在进行时，无法附加虚拟磁盘。

调用方必须具有 READ|对虚拟磁盘的后备存储的写入访问权限。