ILAppendID function

Appends or prepends an SHITEMID structure to an ITEMIDLIST structure.

Syntax

PIDLIST_RELATIVE ILAppendID(
  PIDLIST_RELATIVE pidl,
  LPCSHITEMID      pmkid,
  BOOL             fAppend
);

Parameters

pidl

Type: PIDLIST_RELATIVE

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

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

   
Windows version Windows XP [desktop apps only] 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)