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