Windows Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize

ILIsParent function

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

pidl1 [in]

Type: PCIDLIST_ABSOLUTE

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

pidl2 [in]

Type: PCIDLIST_ABSOLUTE

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

fImmediate [in]

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

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