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.


Notifies clients that the Explorer browser has successfully navigated to a Shell folder.

Notifies clients that the Explorer browser has failed to navigate to a Shell folder.

Notifies clients of a pending Explorer browser navigation to a Shell folder.

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