SHMultiFileProperties function (shlobj.h)

Displays a merged property sheet for a set of files. Property values common to all the files are shown while those that differ display the string (multiple values).

Syntax

SHSTDAPI SHMultiFileProperties(
  [in] IDataObject *pdtobj,
       DWORD       dwFlags
);

Parameters

[in] pdtobj

Type: IDataObject*

A pointer to a data object that supplies the PIDLs of all of the files for which to display the merged property sheet. The data object must use the CFSTR_SHELLIDLIST clipboard format. The parent folder's implementation of IShellFolder::GetDisplayNameOf must return a fully qualified file system path for each item in response to the SHGDN_FORPARSING flag.

dwFlags

Type: DWORD

Reserved. Must be set to 0.

Return value

Type: HRESULT

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj.h
Library Shell32.lib
DLL Shell32.dll (version 5.0 or later)

See also

Shell Clipboard Formats