ILFindChild function (shlobj_core.h)

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)