ILIsParent function

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

Syntax

BOOL ILIsParent(
  PCIDLIST_ABSOLUTE pidl1,
  PCIDLIST_ABSOLUTE pidl2,
  BOOL              fImmediate
);

Parameters

pidl1

Type: PCIDLIST_ABSOLUTE

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

pidl2

Type: PCIDLIST_ABSOLUTE

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

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

   
Windows version Windows XP [desktop apps only] 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)