Метод IFileDialogEvents::OnFolderChanging (shobjidl_core.h)

Вызывается перед IFileDialogEvents::OnFolderChange. Это позволяет реализации остановить переход к определенному расположению.

Синтаксис

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

Параметры

[in] pfd

Тип: IFileDialog*

Указатель на интерфейс, представляющий диалоговое окно.

[in] psiFolder

Тип: IShellItem*

Указатель на интерфейс, представляющий папку, в которую будет переходить диалоговое окно.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае. Возвращаемое значение S_OK или E_NOTIMPL указывает, что изменение папки может продолжаться.

Комментарии

Вызывающее приложение может вызывать IFileDialog::SetFolder во время этого обратного вызова, чтобы перенаправить навигацию в альтернативную папку. Фактическая навигация не выполняется до тех пор, пока не вернется функция IFileDialogEvents::OnFolderChanging .

Если вызывающее приложение просто запрещает переход к определенной папке, должен отображаться пользовательский интерфейс с объяснением ограничения. Чтобы получить родительский HWND для пользовательского интерфейса, получите интерфейс IOleWindow через IFileDialog и вызовите IOleWindow::GetWindow.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)