IVdsService：：Unadvise 方法 (vds.h)

[从Windows 8和Windows Server 2012开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

取消注册调用方 IVdsAdviseSink 接口，以便调用方不再接收来自 VDS 服务的通知。

语法

HRESULT Unadvise(
  [in] DWORD dwCookie
);

[in] dwCookie

此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及特定于 VDS 的返回值。它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序。可能的返回值包括以下内容。

返回代码/值	说明
S_OK	该方法已成功完成。
VDS_E_BAD_COOKIE 0x80042411L	Cookie 不存在。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS 初始化失败。如果应用程序在服务完成初始化之前调用此方法，则会阻止该方法，直到初始化完成。如果初始化失败，则返回此错误。

使用建议方法注册 VDS 应用程序的 IVdsAdviseSink 接口，以接收来自 VDS 的通知。建议返回一个 Cookie，你必须将该 Cookie 作为参数传回 Unadvise 方法。

注意调用建议的应用程序最终必须调用 Unadvise。理想情况下，它应该在不再需要接收通知时立即调用 Unadvise 。

Unadvise 方法可能不会立即返回，因为它等待锁更新已注册客户端应用程序的列表，并等待发送客户端通知的通知线程退出。如果有未完成的通知要发送到应用程序，通知线程会在退出之前尝试发送它们。