Share via


IVdsProviderPrivate::OnUnload 方法 (vdshwprv.h)

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

提示提供者物件取消初始化本身。

語法

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

參數

[in] bForceUnload

如果為 true,VDS 會嘗試強制卸除提供者。 如果為 false,則 VDS 不會進行這類嘗試。

傳回值

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

傳回碼 描述
S_OK
提供者已卸除。
S_FALSE
提供者目前無法卸除。 VDS 稍後再試一次。

備註

VDS 會在釋放提供者對象的參考之前立即呼叫此方法。 當參考計數卸除為零時,提供者會卸除。 如果 OnLoad 方法失敗,VDS 不會呼叫 OnUnload

實作者的注意事項: 即使您未呼叫 OnUnload,您也必須執行所有必要的清除。

規格需求

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

另請參閱

IVdsProviderPrivate

IVdsProviderPrivate::OnLoad