IShellBrowser::BrowseObject

Quick Info

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

[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.