Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Notifies clients that the Explorer browser has failed to navigate to a Shell folder.
Syntax
HRESULT OnNavigationFailed(
[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
| 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) |