IExplorerBrowserEvents::OnNavigationFailed-Methode (shobjidl_core.h)

Benachrichtigt Clients, dass der Explorer-Browser nicht zu einem Shellordner navigieren konnte.

Syntax

HRESULT OnNavigationFailed(
  [in] PCIDLIST_ABSOLUTE pidlFolder
);

Parameter

[in] pidlFolder

Typ: PCIDLIST_ABSOLUTE

Eine PIDL, die den Ordner angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird nach der Methode IExplorerBrowserEvents::OnViewCreated aufgerufen, wenn eine erfolgreiche Ansichtserstellung vorausgesetzt wird.

Nach einer Navigations- und Ansichtserstellung wird entweder IExplorerBrowserEvents::OnNavigationComplete oder IExplorerBrowserEvents::OnNavigationFailed aufgerufen, je nachdem, ob das Ziel navigiert werden kann. Ein Fehler beim Navigieren schließt beispielsweise ein Ziel ein, das nicht erreicht wird, weil keine Route zum Pfad vorhanden ist oder der Benutzer abgebrochen wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)