IExplorerBrowser::BrowseToObject-Methode (shobjidl_core.h)

Artikel
03/02/2024

Navibiert zu einem -Objekt.

Syntax

HRESULT BrowseToObject(
  [in] IUnknown *punk,
  [in] UINT     uFlags
);

Parameter

[in] punk

Typ: IUnknown*

Ein Zeiger auf ein Objekt, zu dem sie navigieren möchten. Wenn das Objekt nicht durchsucht werden kann, wird ein Fehlerwert zurückgegeben.

[in] uFlags

Typ: UINT

Ein Flag, das die Kategorie der pidl angibt. Dies wirkt sich darauf aus, wie die Navigation erreicht wird. Muss der Wert null oder eine bitweise Kombination der folgenden Werte sein.

SBSP_ABSOLUTE

Eine absolute PIDL relativ zum Desktop.

SBSP_RELATIVE

Eine relative PIDL relativ zum aktuellen Ordner.

SBSP_PARENT

Durchsuchen Sie den übergeordneten Ordner, und ignorieren Sie die PIDL.

SBSP_NAVIGATEBACK

Navigieren Sie zurück, und ignorieren Sie die PIDL.

SBSP_NAVIGATEFORWARD

Navigieren Sie vorwärts, ignorieren Sie die PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista und höher. Dieses Flag gibt an, dass alle Suchtexte, die von einem WordWheel (das Suchfeld in Windows Explorer) eingegeben wurden, während dieser Navigation beibehalten werden sollen, sodass Elemente am neuen Speicherort auf die gleiche Weise gefiltert werden, wie sie am vorherigen Speicherort gefiltert wurden.

Rückgabewert

Typ: HRESULT

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

Hinweise

uFlags kann eine der EXPLORER_BROWSER_FILL_FLAGS oder eines der flags sein, die im wFlags-Parameter von BrowseObject definiert sind, mit Ausnahme von Flags, die die Navigation angeben.

Diese Methode ruft GetIDList auf und naviziert die zurückgegebene Pidl. Es funktioniert auf die gleiche Weise wie IExplorerBrowser::BrowseToIDList, mit der Ausnahme, dass Punk nicht NULL sein kann. Die Standardverwendung besteht darin, zu einem IShellFolder oder einem IShellItem zu navigieren. Ein Fehler wird zurückgegeben, wenn das übergebene Objekt nicht durchsucht werden kann. Ein Objekt, das durchsucht werden kann, implementiert entweder IPersistFolder2 oder IPersistIDList.

Die erste Navigation von IExplorerBrowser ist synchron. Danach sind alle Navigationen asynchron. Daher sind Aufrufe von IExplorerBrowser::BrowseToObject erfolgreich, wenn Sie die ausstehende Navigation ordnungsgemäß eingerichtet haben. Dies garantiert jedoch nicht, dass die Navigation erfolgreich ist. Um über Erfolg und Fehler informiert zu werden, sollten Clients IExplorerBrowserEvents implementieren und in OnNavigationComplete und OnNavigationFailed entsprechend reagieren.

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 (shobjidl.h einschließen)

Share via