Saves the file to the location selected by the user in a previous call to IEShowSaveFileDialog.

Syntax

HRESULT IESaveFile(      
    HANDLE hState,
    LPWSTR lpwstrSourceFile
);

Parameters

hState

[in] The handle returned by a previous call to IEShowSaveFileDialog.

lpwstrSourceFile

[in] A string that specifies the full path to the temporary (source) location of the file to be saved.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The IESaveFile function is the second step in a two-step Save operation. The IEShowSaveFileDialog function is used to initialize a Save As dialog box in Windows Internet Explorer. After the user closes the dialog box, Internet Explorer returns information about the user's selection. If this call is successful, a subsequent call to the IESaveFile function must be made to complete the operation.

The handle returned by the IEShowSaveFileDialog function should be used only once. It is not necessary to close the handle; set it to NULL after use. If it is not used, it should be freed by IECancelSaveFile.

Function Information

Stock Implementation	ieframe.dll
Custom Implementation	No
Header	iepmapi.h
Import library	iepmapi.lib
Minimum availability	Internet Explorer 7
Minimum operating systems	Windows Vista