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