IVdsLun::RemovePlex 方法 (vds.h)
[從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 提供者 。 可能的傳回值包括下列專案。
傳回碼/值 | 描述 |
---|---|
|
這個傳回值會向提供者內快取陣列相關資訊的軟體或通訊問題發出訊號。 使用 IVdsHwProvider::Reenumerate 方法,後面接著 IVdsHwProvider::Refresh 方法來還原快取。 |
|
LUN 物件已不存在。 |
|
LUN 處於失敗狀態,無法執行要求的作業。 |
|
另一項作業正在進行中;此作業無法繼續,直到先前的作業或作業完成為止。 |
|
可以從接受 VDS_OBJECT_ID 常數的任何方法傳回。 這個傳回值表示識別碼不會參考現有的物件。 |
備註
移除的 plex 會停止存在,而 VDS 會釋放範圍。 呼叫端無法移除獨立 LUN plex。 請注意,LUN 可能會因為這項作業而失去容錯。 例如,如果作業將 LUN 從鏡像轉換成簡單,則 LUN 不再容錯。
不論呼叫是否起始非同步作業,實作者都必須針對這個方法傳回 IVdsAsync 介面的指標。
如果呼叫端叫用 RemovePlex 方法,並將 plexId 參數設定為不正確值,您應該傳回 VDS_E_OBJECT_NOT_FOUND。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平臺 | Windows |
標頭 | vds.h |
程式庫 | Uuid.lib |