IVdsService：：Unadvise 方法 (vds.h)

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

取消註冊呼叫端的 IVdsAdviseSink 介面，讓呼叫端不再收到來自 VDS 服務的通知。

語法

HRESULT Unadvise(
  [in] DWORD dwCookie
);

[in] dwCookie

註冊IVdsAdviseSink介面時，IVdsService：：Advise方法所傳回的 Cookie。

這個方法可以傳回標準 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，您必須以參數的形式傳回 至 Unadvise 方法。

注意呼叫建議的應用程式最終必須呼叫 Unadvise。在理想情況下，它應該在不再需要收到通知時立即呼叫 Unadvise 。

Unadvise方法可能不會立即傳回，因為它會等候鎖定來更新已註冊的用戶端應用程式清單，並等候傳送用戶端通知的通知執行緒結束。如果有未處理的通知要傳送至您的應用程式，通知執行緒會先嘗試傳送通知再結束。