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
Library Uuid.lib

另请参阅

IVdsProviderPrivate

IVdsProviderPrivate::OnLoad