IExplorerBrowser::Advise 方法 (shobjidl_core.h)

針對事件回呼,起始與 IExplorerBrowser 的連線。

語法

HRESULT Advise(
  [in]  IExplorerBrowserEvents *psbe,
  [out] DWORD                  *pdwCookie
);

參數

[in] psbe

類型: IExplorerBrowserEvents*

要建議 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)

另請參閱

IExplorerBrowser

OnNavigationComplete

OnNavigationFailed

OnViewCreated