ILIsParent function (shlobj_core.h)

Tests whether an ITEMIDLIST structure is the parent of another ITEMIDLIST structure.

Syntax

BOOL ILIsParent(
  [in] PCIDLIST_ABSOLUTE pidl1,
  [in] PCIDLIST_ABSOLUTE pidl2,
  [in] BOOL              fImmediate
);

Parameters

[in] pidl1

Type: PCIDLIST_ABSOLUTE

A pointer to an ITEMIDLIST (PIDL) structure that specifies the parent. This must be an absolute PIDL.

[in] pidl2

Type: PCIDLIST_ABSOLUTE

A pointer to an ITEMIDLIST (PIDL) structure that specifies the child. This must be an absolute PIDL.

[in] fImmediate

Type: BOOL

A Boolean value that is set to TRUE to test for immediate parents of pidl2, or FALSE to test for any parents of pidl2.

Return value

Type: BOOL

Returns TRUE if pidl1 is a parent of pidl2. If fImmediate is set to TRUE, the function only returns TRUE if pidl1 is the immediate parent of pidl2. Otherwise, the function returns FALSE.

Requirements