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