Quick Info

Windows NT
Yes
Win95
Yes
Win32s
Yes
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

IShellBrowser::BrowseObject

[Now Supported on Windows NT]

Tells the Explorer to browse to another folder.

HRESULT BrowseObject(

LPCITEMIDLIST pidl,
// Address of item identifier list
UINT *wFlags
// Specifies the folder to be browsed
);

Parameters

pidl

Address of an ITEMIDLIST (item identifier list) structure that specifies an object's location. This value is dependent on the wFlags parameter.

wFlags

Flag specifying the folder to be browsed. It can be zero or more of the following values. The first three specify whether another window is to be created.

SBSP_SAMEBROWSER
Browse to another folder with the same Explorer window.
SBSP_NEWBROWSER
Creates another window for the specified folder.
SBSP_DEFBROWSER
The default behavior is to respect the view option (the user setting to create new windows or to browse in place). In most cases, callers should use this flag.

The following flags specify either the open, explore, or default mode. These values are ignored if SBSP_SAMEBROWSER or (SBSP_DEFBROWSER && (single window browser || explorer)).

SBSP_OPENMODE
Use a normal folder window.
SBSP_EXPLOREMODE
Use an Explorer window.
SBSP_DEFMODE
Us the same one as the current window.

The following flags specify the pidl parameter's category:

SBSP_ABSOLUTE
An absolute pidl (relative from the desktop).
SBSP_RELATIVE
A relative pidl (relative from the current folder).
SBSP_PARENT
Browse the parent folder (ignores the pidl).

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

Views can use this method to force the Explorer to browse to a specific place in the namespace. Typically, these are folders contained in the view.

See Also

IShellBrowser

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database