IExplorerBrowser::Advise 方法 (shobjidl_core.h)
为事件回调启动与 IExplorerBrowser 的连接。
语法
HRESULT Advise(
[in] IExplorerBrowserEvents *psbe,
[out] DWORD *pdwCookie
);
参数
[in] psbe
指向要通知 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) |