Método IFileDialog2::SetNavigationRoot (shobjidl.h)
Especifica una ubicación de nivel superior desde la que empezar a examinar un espacio de nombres, por ejemplo, en la opción Guardar carpeta Examinar del cuadro de diálogo. Los usuarios no pueden navegar por encima de esta ubicación.
Sintaxis
HRESULT SetNavigationRoot(
[in] IShellItem *psi
);
Parámetros
[in] psi
Tipo: IShellItem
Puntero a un objeto IShellItem que representa la raíz de navegación.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Las aplicaciones que quieran restringir la navegación a un área determinada del espacio de nombres shell pueden usar SetNavigationRoot. Los elementos del panel de navegación se reemplazan por el elemento proporcionado, para guiar al usuario de navegar fuera de esta parte del espacio de nombres.
No se puede llamar a este método mientras se muestra el cuadro de diálogo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl.h |
| Library | Comdlg32.lib |
| Archivo DLL | Comdlg32.dll (versión 6.1 o posterior) |