IExplorerBrowser::BrowseToIDList-Methode (shobjidl_core.h)

  • Artikel

Navigieren zu einem Zeiger auf eine Elementbezeichnerliste (PIDL)

Syntax

HRESULT BrowseToIDList(
  [in] PCUIDLIST_RELATIVE pidl,
  [in] UINT               uFlags
);

Parameter

[in] pidl

Typ: PCUIDLIST_RELATIVE

Ein Zeiger auf eine const ITEMIDLIST (Elementbezeichnerliste), die den Speicherort eines Objekts als Ziel angibt, zu dem navigiert werden soll. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie in den Hinweisen.

[in] uFlags

Typ: UINT

Ein Flag, das die Kategorie der pidl angibt. Dies wirkt sich auf die Navigation aus. 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

Navigieren Sie zum übergeordneten Ordner, und ignorieren Sie die PIDL.

SBSP_NAVIGATEBACK

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

SBSP_NAVIGATEFORWARD

Navigieren Sie vorwärts, und ignorieren Sie die PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista und höher. Dieses Flag gibt an, dass der von einem WordWheel eingegebene Suchtext (das Suchfeld in Windows Explorer) während dieser Navigation beibehalten werden soll, sodass Elemente an der neuen Position so 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

Der Pidl-Parameter kann NULL sein, wenn die in uFlags angegebenen Flags die Navigation durch das integrierte TravelLog,d. h. SBSP_NAVIGATEBACK oder SBSP_NAVIGATEFORWARD anzeigen.

Diese Methode unterstützt nur eine Teilmenge der SBSP-Flags, die in der Datei shobjidl.h aufgeführt sind. Daher gibt diese Methode E_INVALIDARG zurück, wenn SBSP_NEWBROWSER oder SBSP_EXPLOREMODE in uFlags angegeben sind.

Anforderungen

   
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)

Weitere Informationen

BrowseObject

IExplorerBrowser