Skip to content

Latest commit

 

History

History
99 lines (69 loc) · 4.11 KB

nf-shobjidl_core-iexplorerbrowser-advise.md

File metadata and controls

99 lines (69 loc) · 4.11 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:shobjidl_core.IExplorerBrowser.Advise
IExplorerBrowser::Advise (shobjidl_core.h)
Initiates a connection with IExplorerBrowser for event callbacks.
Advise
Advise method [Windows Shell]
Advise method [Windows Shell]
IExplorerBrowser interface
IExplorerBrowser interface [Windows Shell]
Advise method
IExplorerBrowser.Advise
IExplorerBrowser::Advise
_shell_IExplorerBrowser_Advise
shell.IExplorerBrowser_Advise
shobjidl_core/IExplorerBrowser::Advise
shell\IExplorerBrowser_Advise.htm
shell
b77f9c41-248e-4f16-a9ff-6ff5437df11c
12/05/2018
Advise, Advise method [Windows Shell], Advise method [Windows Shell],IExplorerBrowser interface, IExplorerBrowser interface [Windows Shell],Advise method, IExplorerBrowser.Advise, IExplorerBrowser::Advise, _shell_IExplorerBrowser_Advise, shell.IExplorerBrowser_Advise, shobjidl_core/IExplorerBrowser::Advise
shobjidl_core.h
Shobjidl.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Shobjidl.idl
Windows
19H1
IExplorerBrowser::Advise
shobjidl_core/IExplorerBrowser::Advise
c++
APIRef
kbSyntax
COM
shobjidl_core.h
IExplorerBrowser.Advise

IExplorerBrowser::Advise

-description

Initiates a connection with IExplorerBrowser for event callbacks.

-parameters

-param psbe [in]

Type: IExplorerBrowserEvents*

A pointer to the IExplorerBrowserEvents interface of the object to be advised of IExplorerBrowser events.

-param pdwCookie [out]

Type: DWORD*

When this method returns, contains a token that uniquely identifies the event listener. This allows several event listeners to be subscribed at a time.

-returns

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

This method is called by an implementer of IExplorerBrowserEvents. The implementer (listener) is advised of ExplorerBrowser view and navigation events by callback of the methods of IExplorerBrowserEvents.

Call IExplorerBrowser::Advise to initiate an advisory connection prior to the first IExplorerBrowser navigation. Callbacks to event listeners are made as the browser is browsing.

The first browse happens synchronously to a call on IExplorerBrowser::BrowseToObject, or a similar method. Future callbacks happen asynchronously, as the browser browses.

When the connection is no longer needed, call method IExplorerBrowser::Unadvise to terminate the connection.

-see-also

IExplorerBrowser

OnNavigationComplete

OnNavigationFailed

OnViewCreated