UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:shobjidl_core.IFileDialogEvents.OnFolderChanging |
IFileDialogEvents::OnFolderChanging (shobjidl_core.h) |
Called before IFileDialogEvents::OnFolderChange. This allows the implementer to stop navigation to a particular location. |
|
shell\IFileDialogEvents_OnFolderChanging.htm |
shell |
4114ed48-8e1e-4ddf-9434-629b99fc40d9 |
12/05/2018 |
IFileDialogEvents interface [Windows Shell],OnFolderChanging method, IFileDialogEvents.OnFolderChanging, IFileDialogEvents::OnFolderChanging, OnFolderChanging, OnFolderChanging method [Windows Shell], OnFolderChanging method [Windows Shell],IFileDialogEvents interface, shell.IFileDialogEvents_OnFolderChanging, shell_IFileDialogEvents_OnFolderChanging, shobjidl_core/IFileDialogEvents::OnFolderChanging |
shobjidl_core.h |
Shobjidl.h |
Windows |
Windows Vista [desktop apps only] |
Windows Server 2008 [desktop apps only] |
Shobjidl.idl |
Windows |
19H1 |
|
|
|
|
|
|
Called before IFileDialogEvents::OnFolderChange. This allows the implementer to stop navigation to a particular location.
Type: IFileDialog*
A pointer to the interface that represents the dialog.
Type: IShellItem*
A pointer to an interface that represents the folder to which the dialog is about to navigate.
Type: HRESULT
Returns S_OK if successful, or an error value otherwise. A return value of S_OK or E_NOTIMPL indicates that the folder change can proceed.
The calling application can call IFileDialog::SetFolder during this callback to redirect navigation to an alternate folder. The actual navigation does not occur until IFileDialogEvents::OnFolderChanging has returned.
If the calling application simply prevents navigation to a particular folder, UI should be displayed with an explanation of the restriction. To obtain a parent HWND for the UI, obtain the IOleWindow interface through IFileDialog and call IOleWindow::GetWindow.