IESaveFile function

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

Syntax

HRESULT IESaveFile(
  _In_ HANDLE hState,
  _In_ 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

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

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.

Requirements