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

Chamado antes de IFileDialogEvents::OnFolderChange. Isso permite que o implementador interrompa a navegação para um local específico.

Sintaxe

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

Parâmetros

[in] pfd

Tipo: IFileDialog*

Um ponteiro para a interface que representa a caixa de diálogo.

[in] psiFolder

Tipo: IShellItem*

Um ponteiro para uma interface que representa a pasta para a qual a caixa de diálogo está prestes a navegar.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro. Um valor retornado de S_OK ou E_NOTIMPL indica que a alteração de pasta pode continuar.

Comentários

O aplicativo de chamada pode chamar IFileDialog::SetFolder durante esse retorno de chamada para redirecionar a navegação para uma pasta alternativa. A navegação real não ocorre até que IFileDialogEvents::OnFolderChanging tenha retornado.

Se o aplicativo de chamada simplesmente impedir a navegação para uma pasta específica, a interface do usuário deverá ser exibida com uma explicação da restrição. Para obter um HWND pai para a interface do usuário, obtenha a interface IOleWindow por meio de IFileDialog e chame IOleWindow::GetWindow.

Requisitos