Método IFileDialog::SetFolder (shobjidl_core.h)

Establece una carpeta que siempre se selecciona cuando se abre el cuadro de diálogo, independientemente de la acción del usuario anterior.

Sintaxis

HRESULT SetFolder(
  [in] IShellItem *psi
);

Parámetros

[in] psi

Tipo: IShellItem*

Puntero a la interfaz que representa la carpeta.

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

Esta carpeta invalida cualquier carpeta "usada más recientemente". Si se llama a este método mientras se muestra el cuadro de diálogo, hace que el diálogo navegue a la carpeta especificada.

En general, no se recomienda el uso de este método. Si llama a SetFolder antes de mostrar el cuadro de diálogo, no se muestra la ubicación más reciente en la que el usuario guardó o abrió desde. A menos que haya una razón muy específica para este comportamiento, no es una experiencia de usuario buena o esperada y, por tanto, debe evitarse. En casi todas las instancias, IFileDialog::SetDefaultFolder es el mejor método.

A partir de Windows 7, si la ruta de acceso de la carpeta especificada a través de psi es la ruta de acceso predeterminada de una carpeta conocida, la ruta de acceso actual de la carpeta conocida se usa en el cuadro de diálogo. Esa ruta de acceso podría no ser la misma que la ruta especificada en psi; por ejemplo, si se ha redirigido la carpeta conocida. Si la carpeta conocida es una biblioteca (carpetas virtuales Documentos, Música, Imágenes y Vídeos), la ruta de acceso de la biblioteca se usa en el cuadro de diálogo. Si la biblioteca especificada está oculta (tal como están de forma predeterminada a partir de Windows 8.1), la ubicación de guardado predeterminada de la biblioteca se usa en el cuadro de diálogo, como la carpeta Documentos de Microsoft OneDrive para la biblioteca documentos. Debido a estas asignaciones, es posible que la ubicación de la carpeta usada en el cuadro de diálogo no sea exactamente como se especificó al llamar a este método.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)