IFileDialogEvents::OnFolderChanging, méthode (shobjidl_core.h)

Appelé avant IFileDialogEvents::OnFolderChange. Cela permet à l’implémenteur d’arrêter la navigation vers un emplacement particulier.

Syntaxe

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

Paramètres

[in] pfd

Type : IFileDialog*

Pointeur vers l’interface qui représente le dialogue.

[in] psiFolder

Type : IShellItem*

Pointeur vers une interface qui représente le dossier vers lequel la boîte de dialogue est sur le point de naviguer.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Une valeur de retour S_OK ou E_NOTIMPL indique que le changement de dossier peut se poursuivre.

Remarques

L’application appelante peut appeler IFileDialog::SetFolder pendant ce rappel pour rediriger la navigation vers un autre dossier. La navigation réelle ne se produit pas tant que IFileDialogEvents::OnFolderChanging n’est pas retourné.

Si l’application appelante empêche simplement la navigation vers un dossier particulier, l’interface utilisateur doit s’afficher avec une explication de la restriction. Pour obtenir un HWND parent pour l’interface utilisateur, obtenez l’interface IOleWindow via IFileDialog et appelez IOleWindow::GetWindow.

Configuration requise