ILAppendID function (shlobj_core.h)

Appends or prepends an SHITEMID structure to an ITEMIDLIST structure.

Syntax

PIDLIST_RELATIVE ILAppendID(
  [in, optional] PIDLIST_RELATIVE pidl,
  [in]           LPCSHITEMID      pmkid,
                 BOOL             fAppend
);

Parameters

[in, optional] pidl

Type: PIDLIST_RELATIVE

A pointer to an ITEMIDLIST structure. When the function returns, the SHITEMID structure specified by pmkid is appended or prepended.

[in] pmkid

Type: LPSHITEMID

A pointer to a SHITEMID structure to be appended or prepended to pidl.

fAppend

Type: BOOL

Value that is set to TRUE to append pmkid to pidl. Set this value to FALSE to prepend pmkid to pidl.

Return value

Type: PIDLIST_RELATIVE

Returns the ITEMIDLIST structure specified by pidl, with pmkid appended or prepended. Returns NULL on failure.

Requirements