IVdsPack：：ReplaceDisk 方法 (vds.h)

[从 Windows 8 和 Windows Server 2012 开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

不支持。

此方法保留供将来使用。

语法

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

[in] OldDiskId

旧磁盘的 GUID。

[in] NewDiskId

新磁盘的 GUID。

[out] ppAsync

VDS 在返回时初始化的 IVdsAsync 接口指针的地址。调用方必须释放接口。使用此接口可取消、等待或查询操作的状态。

此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及特定于 VDS 的返回值。它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序。可能的返回值包括以下内容。

返回代码/值	说明
S_OK	磁盘更换已成功完成。
VDS_E_NOT_SUPPORTED 0x80042400L	此版本不支持此方法。

调用方可以使用此方法进行媒体迁移， (将旧磁盘替换为新磁盘) ，或者在修复具有缺失或失败成员的容错集时，尤其是那些未实现热备份的提供程序。

新磁盘必须与旧磁盘位于同一包中，不能包含数据;它可能具有错误的分区样式。如果成功替换，旧磁盘将保留分区样式，但没有有效的卷。

无论调用是否启动异步操作，实现者都必须返回指向此方法的 IVdsAsync 接口的指针。如果提供程序未实现热备份，则它必须支持失败的成员方案：在调用方调用 ReplaceDisk 方法后，再次开始同步公开的容错卷。