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