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 |
|
|
Library |
|
|
DLL |
|
Show: