Export (0) Print
Expand All
Expand Minimize

ILFindChild function

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

Syntax


PUIDLIST_RELATIVE ILFindChild(
  _In_  PCIDLIST_ABSOLUTE pidlParent,
  _In_  PCIDLIST_ABSOLUTE pidlChild
);

Parameters

pidlParent [in]

Type: PCIDLIST_ABSOLUTE

A pointer to the parent ITEMIDLIST structure.

pidlChild [in]

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft