IExplorerBrowserEvents::OnNavigationPending method (shobjidl_core.h)

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

Syntax

HRESULT OnNavigationPending(
  [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

Explorer browser calls this method before it navigates to a folder, that is, before calling IExplorerBrowserEvents::OnNavigationFailed or IExplorerBrowserEvents::OnNavigationComplete.

Returning any failure code from this method, including E_NOTIMPL, will cancel the navigation.

Requirements

Requirement Value
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)