Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |