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) |