Edit

ILAppendID function (shlobj_core.h)

  • Article

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

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)