IExplorerBrowser::Advise 方法 (shobjidl_core.h)

为事件回调启动与 IExplorerBrowser 的连接。

语法

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

参数

[in] psbe

类型: IExplorerBrowserEvents*

指向要通知 IExplorerBrowser 事件的对象的 IExplorerBrowserEvents 接口的 指针。

[out] pdwCookie

类型: DWORD*

此方法返回时,包含唯一标识事件侦听器的标记。 这允许一次订阅多个事件侦听器。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法由 IExplorerBrowserEvents 的实现者调用。 通过回调 IExplorerBrowserEvents 的方法,向实现者 (侦听器) 建议 ExplorerBrowser 视图和导航事件。

调用 IExplorerBrowser::Advise 以在第一个 IExplorerBrowser 导航之前启动咨询连接。 对事件侦听器的回调是在浏览器浏览时发出的。

第一次浏览与 IExplorerBrowser::BrowseToObject 或类似方法上的调用同步发生。 将来的回调在浏览器浏览时异步发生。

如果不再需要连接,请调用方法 IExplorerBrowser::Unadvise 以终止连接。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

IExplorerBrowser

OnNavigationComplete

OnNavigationFailed

OnViewCreated