IFileSaveDialog::SetSaveAsItem method (shobjidl_core.h)

Sets an item to be used as the initial entry in a Save As dialog.

Syntax

HRESULT SetSaveAsItem(
  [in] IShellItem *psi
);

Parameters

[in] psi

Type: IShellItem*

Pointer to an IShellItem that represents the item.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The name of the item is displayed in the file name edit box, and the containing folder is opened in the view. This would generally be used when the application is saving an item that already exists. For new items, use IFileDialog::SetFileName.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h