IExplorerBrowserEvents interface (shobjidl_core.h)

Exposes methods for notification of Explorer browser navigation and view creation events.


The IExplorerBrowserEvents interface inherits from the IUnknown interface. IExplorerBrowserEvents also has these types of members:


The IExplorerBrowserEvents interface has these methods.

Method Description
IExplorerBrowserEvents::OnNavigationComplete Notifies clients that the Explorer browser has successfully navigated to a Shell folder.
IExplorerBrowserEvents::OnNavigationFailed Notifies clients that the Explorer browser has failed to navigate to a Shell folder.
IExplorerBrowserEvents::OnNavigationPending Notifies clients of a pending Explorer browser navigation to a Shell folder.
IExplorerBrowserEvents::OnViewCreated Notifies clients that the view of the Explorer browser has been created and can be modified.


Implement this interface to be notified of IExplorerBrowser navigation and view creation events; implementation enables handling of these events, if desired.

IExplorerBrowser must be notified of implementers (clients) who want to be advised of IExplorerBrowser events. Clients do this by calling the IExplorerBrowser::Advise method. This enables event callbacks by IExplorerBrowser to the client using the methods in IExplorerBrowserEvents. To stop event callbacks, the client must call method IExplorerBrowser::Unadvise or a memory leak may result.

During its first navigation (IExplorerBrowser::BrowseToObject), Explorer calls the methods in this interface synchronously. After that, Explorer calls them asynchronously. The order of the event callbacks is as follows: IExplorerBrowserEvents::OnNavigationPending; IExplorerBrowserEvents::OnViewCreated; and IExplorerBrowserEvents::OnNavigationComplete or IExplorerBrowserEvents::OnNavigationFailed depending on whether the navigation succeeded or failed.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also