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 之前,实际导航不会发生。

如果调用应用程序只是阻止导航到特定文件夹,则应显示 UI 并说明限制。 若要获取 UI 的父 HWND,请通过 IFileDialog 获取 IOleWindow 接口并调用 IOleWindow::GetWindow

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)