SHCreateDefaultPropertiesOp function

Creates a file operation that sets the default properties on the Shell item that have not already been set.


SHSTDAPI SHCreateDefaultPropertiesOp(
  IShellItem     *psi,
  IFileOperation **ppFileOp



Type: IShellItem*

A pointer to the source shell item. See IShellItem.


Type: IFileOperation**

The address of the IFileOperation interface pointer.

Return Value


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


The list of properties to set a default value comes from the SetDefaultsFor registry entry under the ProgID for the file association of the item. The list is prefixed by prop: and contains the canonical names of the properties to set the default value, for example, prop:System.Author;System.Document.DateCreated. The possible properties for this list are System.Author, System.Document.DateCreated, and System.Photo.DateTaken. If the SetDefaultsFor entry does not exist on the ProgID, this function uses the default found on the SetDefaultsFor entry of HKEY_CLASSES_ROOT<b>*.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl.h
DLL Shell32.dll