IExplorerBrowserEvents::OnNavigationComplete method (shobjidl_core.h)

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

Syntax

HRESULT OnNavigationComplete(
  [in] PCIDLIST_ABSOLUTE pidlFolder
);

Parameters

[in] pidlFolder

Type: PCIDLIST_ABSOLUTE

A PIDL that specifies the folder.

Return value

Type: HRESULT

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

Remarks

This method is called after method IExplorerBrowserEvents::OnViewCreated, assuming a successful view creation.

After a navigation and view creation, either IExplorerBrowserEvents::OnNavigationComplete or IExplorerBrowserEvents::OnNavigationFailed is called depending on whether the destination could be navigated to. For example, a failure to navigate includes a destination that is not reached either because there is no route to the path or the user has canceled.

Requirements