IExplorerBrowser::Advise 方法 (shobjidl_core.h)
針對事件回呼,起始與 IExplorerBrowser 的連線。
語法
HRESULT Advise(
[in] IExplorerBrowserEvents *psbe,
[out] DWORD *pdwCookie
);
參數
[in] psbe
要建議 IExplorerBrowserBrowser 事件之物件的 IExplorerBrowserEvents 介面指標。
[out] pdwCookie
類型: DWORD*
當這個方法傳回時,包含可唯一識別事件接聽程式的令牌。 這可讓一次訂閱數個事件接聽程式。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
這個方法是由 IExplorerBrowserEvents 的實作者呼叫。 實作者 (接聽程式) 是透過 IExplorerBrowserEvents 方法的回呼來建議ExplorerBrowser 檢視和流覽事件。
呼叫 IExplorerBrowser::建議 在第一個 IExplorerBrowser 流覽之前起始諮詢連線。 當瀏覽器正在瀏覽時,就會對事件接聽程式進行回呼。
第一次流覽會同步發生到 IExplorerBrowser::BrowseToObject 或類似方法的呼叫。 當瀏覽器瀏覽時,未來的回呼會以異步方式進行。
不再需要連線時,呼叫方法 IExplorerBrowser::Unadvise 以終止連線。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包括 Shobjidl.h) |