IVdsLun：：RemovePlex 方法 (vdshwprv.h)

發行項
03/03/2024

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

從 LUN 移除 plex。

語法

HRESULT RemovePlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

參數

[in] plexId

要移除之 LUN plex 的 GUID。

[out] ppAsync

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

如果您在此方法上呼叫 IVdsAsync：：Wait，並傳回成功的 HRESULT 值，您必須在每個介面指標上呼叫 IUnknown：：Release 方法，以釋放在 VDS_ASYNC_OUTPUT 結構中傳回的介面。不過，如果 Wait 傳回失敗 HRESULT 值，或 Wait 的 pHrResult 參數收到失敗 HRESULT 值，則VDS_ASYNC_OUTPUT結構中的介面指標為 NULL 且不需要釋放。您可以使用 Winerror.h 中定義的 SUCCEEDED 和 FAILED 宏來測試成功或失敗 HRESULT 值。

傳回值

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

傳回碼/值	Description
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	這個傳回值會向提供者內快取數位相關信息的軟體或通訊問題發出訊號。使用 IVdsHwProvider：：Reenumerate 方法，後面接著 IVdsHwProvider：：Refresh 方法來還原快取。
VDS_E_OBJECT_DELETED 0x8004240BL	LUN 物件已不存在。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	LUN 處於失敗狀態，無法執行要求的作業。
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	另一項作業正在進行中;此作業無法繼續，直到先前的作業或作業完成為止。
VDS_E_OBJECT_NOT_FOUND 0x80042405L	可以從接受 VDS_OBJECT_ID 常數的任何方法傳回。這個傳回值表示標識元不會參考現有的物件。

備註

拿掉的 plex 會停止存在，而 VDS 會釋放範圍。呼叫端無法移除獨立 LUN plex。請注意，LUN 可能會因為這項作業而失去容錯。例如，如果作業將 LUN 從鏡像轉換成簡單，則 LUN 不再容錯。

不論呼叫是否起始異步操作，實作者都必須針對這個方法傳回 IVdsAsync 介面的指標。

如果呼叫端叫用 RemovePlex 方法，並將 plexId 參數設定為無效的值，您應該傳回 VDS_E_OBJECT_NOT_FOUND。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	vdshwprv.h
程式庫	Uuid.lib