IFileSaveDialog::ApplyProperties method (shobjidl_core.h)

Applies a set of properties to an item using the Shell's copy engine.

Syntax

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

Parameters

[in] psi

Type: IShellItem*

Pointer to the IShellItem that represents the file being saved. This is usually the item retrieved by GetResult.

[in] pStore

Type: IPropertyStore*

Pointer to the IPropertyStore that represents the property values to be applied to the file. This can be the property store returned by IFileSaveDialog::GetProperties.

[in] hwnd

Type: HWND

The handle of the application window.

[in] pSink

Type: IFileOperationProgressSink*

Pointer to an optional IFileOperationProgressSink that the calling application can use if they want to be notified of the progress of the property stamping. This value may be NULL.

Return value

Type: HRESULT

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

Remarks

This method should be used when the application has turned on property collection (IFileSaveDialog::SetCollectedProperties), but does not persist the properties themselves into the saved file.

Requirements