ILFindChild function (shlobj_core.h)

  • Article

Determines whether a specified ITEMIDLIST structure is the child of another ITEMIDLIST structure.

Syntax

PUIDLIST_RELATIVE ILFindChild(
  [in] PIDLIST_ABSOLUTE  pidlParent,
  [in] PCIDLIST_ABSOLUTE pidlChild
);

Parameters

[in] pidlParent

Type: PCIDLIST_ABSOLUTE

A pointer to the parent ITEMIDLIST structure.

[in] pidlChild

Type: PCIDLIST_ABSOLUTE

A pointer to the child ITEMIDLIST structure.

Return value

Type: PUIDLIST_RELATIVE

Returns a pointer to the child's simple ITEMIDLIST structure if pidlChild is a child of pidlParent. The returned structure consists of pidlChild, minus the SHITEMID structures that make up pidlParent. Returns NULL if pidlChild is not a child of pidlParent.

Note  The returned pointer is a pointer into the existing parent structure. It is an alias for pidlChild. No new memory is allocated in association with the returned pointer. It is not the caller's responsibility to free the returned value.
 

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)