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 を呼び出します。

要件