IExplorerBrowserEvents::OnNavigationFailed method
Notifies clients that the Explorer browser has failed to navigate to a Shell folder.
Syntax
HRESULT OnNavigationFailed(
[in] PCIDLIST_ABSOLUTE pidlFolder
);
Parameters
- pidlFolder [in]
-
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
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|