IFileDialog2::SetNavigationRoot method (shobjidl.h)
Specifies a top-level location from which to begin browsing a namespace, for instance in the Save dialog's Browse folder option. Users cannot navigate above this location.
HRESULT SetNavigationRoot( [in] IShellItem *psi );
Pointer to an IShellItem object that represents the navigation root.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
SetNavigationRoot can be used by applications that want to restrict navigation to a certain area of the Shell namespace. Items in the navigation pane are replaced with the supplied item, to guide the user from navigating outside of this part of the namespace.
This method cannot be called while the dialog is being displayed.
|Minimum supported client||Windows 7 [desktop apps only]|
|Minimum supported server||Windows Server 2008 R2 [desktop apps only]|
|DLL||Comdlg32.dll (version 6.1 or later)|