[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