Método IFileDialogEvents::OnFolderChanging (shobjidl_core.h)

Se llama antes de IFileDialogEvents::OnFolderChange. Esto permite al implementador detener la navegación a una ubicación determinada.

Sintaxis

HRESULT OnFolderChanging(
  [in] IFileDialog *pfd,
  [in] IShellItem  *psiFolder
);

Parámetros

[in] pfd

Tipo: IFileDialog*

Puntero a la interfaz que representa el cuadro de diálogo.

[in] psiFolder

Tipo: IShellItem*

Puntero a una interfaz que representa la carpeta a la que está a punto de navegar el cuadro de diálogo.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error. Un valor devuelto de S_OK o E_NOTIMPL indica que el cambio de carpeta puede continuar.

Comentarios

La aplicación que llama puede llamar a IFileDialog::SetFolder durante esta devolución de llamada para redirigir la navegación a una carpeta alternativa. La navegación real no se produce hasta que se ha devuelto IFileDialogEvents::OnFolderChanging .

Si la aplicación que llama simplemente impide la navegación a una carpeta determinada, la interfaz de usuario debe mostrarse con una explicación de la restricción. Para obtener un HWND primario para la interfaz de usuario, obtenga la interfaz IOleWindow a través de IFileDialog y llame a IOleWindow::GetWindow.

Requisitos

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 (incluya Shobjidl.h)