SHCreateStdEnumFmtEtc function (shlobj_core.h)

[SHCreateStdEnumFmtEtc is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Creates an IEnumFORMATETC object from an array of FORMATETC structures.

Syntax

SHSTDAPI SHCreateStdEnumFmtEtc(
  [in]  UINT               cfmt,
        const FORMATETC [] afmt,
  [out] IEnumFORMATETC     **ppenumFormatEtc
);

Parameters

[in] cfmt

Type: UINT

The number of entries in the afmt array.

afmt

Type: const FORMATETC[]

An array of FORMATETC structures that specifies the clipboard formats of interest.

[out] ppenumFormatEtc

Type: IEnumFORMATETC**

When this function returns successfully, receives an IEnumFORMATETC interface pointer. Receives NULL on failure.

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 XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (version 5.0 or later)
API set ext-ms-win-shell-shell32-l1-2-1 (introduced in Windows 10, version 10.0.10240)