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

IVdsAsync 介面指標的位址，VDS 會在傳回時初始化。呼叫端必須釋放介面。使用此介面來取消、等候或查詢作業的狀態。

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。錯誤可能來自 VDS 本身，或來自正在使用的基礎 VDS 提供者。可能的傳回值包括下列專案。

傳回碼/值	描述
S_OK	磁碟更換已順利完成。
VDS_E_NOT_SUPPORTED 0x80042400L	這個版本不支援此方法。

呼叫端可以使用此方法進行媒體移轉， (將舊的磁碟取代為新的磁碟) ，或修復具有遺漏或失敗成員的容錯集時，特別是針對未實作經常性疏除的提供者。

新的磁碟必須位於與舊磁碟相同的套件中，而且不能包含數據;它可能會有錯誤的分割樣式。如果成功取代，舊磁碟會保留數據分割樣式，但沒有有效的磁碟區。

不論呼叫是否起始異步操作，實作者都必須針對這個方法傳回 IVdsAsync 介面的指標。如果您的提供者未實作經常性存取，它必須支持失敗的成員案例：在呼叫端叫用 ReplaceDisk 方法之後，再次開始同步處理公開的容錯磁碟區。