ILCombine function (shlobj_core.h)

Combines two ITEMIDLIST structures.

Syntax

PIDLIST_ABSOLUTE ILCombine(
  [in] PCIDLIST_ABSOLUTE  pidl1,
  [in] PCUIDLIST_RELATIVE pidl2
);

Parameters

[in] pidl1

Type: PCIDLIST_ABSOLUTE

A pointer to the first ITEMIDLIST structure.

[in] pidl2

Type: PCUIDLIST_RELATIVE

A pointer to the second ITEMIDLIST structure. This structure is appended to the structure pointed to by pidl1.

Return value

Type: PIDLIST_ABSOLUTE

Returns an ITEMIDLIST containing the combined structures. If you set either pidl1 or pidl2 to NULL, the returned ITEMIDLIST structure is a clone of the non-NULL parameter. Returns NULL if pidl1 and pidl2 are both set to NULL.

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)