共用方式為


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

規格需求

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

另請參閱

IVdsAdviseSink

IVdsService

IVdsService::建議

VDS 通知