IFileDialogEvents::OnFolderChanging method

Called before IFileDialogEvents::OnFolderChange. This allows the implementer to stop navigation to a particular location.

Syntax


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

Parameters

pfd [in]

Type: IFileDialog*

A pointer to the interface that represents the dialog.

psiFolder [in]

Type: IShellItem*

A pointer to an interface that represents the folder to which the dialog is about to navigate.

Return value

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.

Remarks

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.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.