IAPI::GetSaveDlgFileName

property GetSaveDlgFileName.

Displays a common save as file dialogbox for selecting a full filename.

HRESULT GetSaveDlgFileName(
 BSTR filters,
 BSTR title,
 long Style,
 BSTR *pVal
);

Parameters

filters

[in] . File extensions string such as "All (*.*)|*.*|Word (*.doc)|*.doc|"

title

[in] . Title text

Prefixing 'title' string with '<hwndParent>@HWND:' token will attach common dialogs

to a parent Window ( e.g: "5489@HWND:Locate a new path:" )

Style

[in] . One of both following value can be used :

31 for old and legacy style

95 for new style.

pVal

[out, retval] The returned value is the selected full filename for saving.

Return Values

S_OK

The operation was successfull.

E_POINTER

A NULL pointer was supplied as an argument.

E_UNEXPECTED

An unexpected error occoured.

See Also

IAPI