IFileDialog2::SetNavigationRoot-Methode (shobjidl.h)

Gibt einen Speicherort auf oberster Ebene an, von dem aus mit dem Durchsuchen eines Namespace begonnen werden soll, für instance in der Option Ordner durchsuchen des Dialogfelds Speichern. Benutzer können nicht über diesen Speicherort navigieren.

Syntax

HRESULT SetNavigationRoot(
  [in] IShellItem *psi
);

Parameter

[in] psi

Typ: IShellItem

Zeiger auf ein IShellItem-Objekt , das den Navigationsstamm darstellt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

SetNavigationRoot kann von Anwendungen verwendet werden, die die Navigation auf einen bestimmten Bereich des Shellnamespace einschränken möchten. Elemente im Navigationsbereich werden durch das angegebene Element ersetzt, um den Benutzer von der Navigation außerhalb dieses Teils des Namespaces zu leiten.

Diese Methode kann nicht aufgerufen werden, während das Dialogfeld angezeigt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h
Bibliothek	Comdlg32.lib
DLL	Comdlg32.dll (Version 6.1 oder höher)

Weitere Informationen

IFileDialog2