ILCloneFirst function (shlobj_core.h)

Clones the first SHITEMID structure in an ITEMIDLIST structure.

Syntax

PITEMID_CHILD ILCloneFirst(
  [in] PCUIDLIST_RELATIVE pidl
);

Parameters

[in] pidl

Type: PCUIDLIST_RELATIVE

A pointer to the ITEMIDLIST structure that you want to clone.

Return value

Type: PITEMID_CHILD

A pointer to an ITEMIDLIST structure that contains the first SHITEMID structure from the ITEMIDLIST structure specified by pidl. Returns NULL on failure.

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)

See also

ILClone