ILIsEmpty function (shlobj_core.h)

Verifies whether an ITEMIDLIST structure is empty.

Syntax

BOOL ILIsEmpty(
  [in] PCUIDLIST_RELATIVE pidl
);

Parameters

[in] pidl

Type: PCUID_RELATIVE

A pointer to the ITEMIDLIST structure to be checked.

Return value

Type: BOOL

TRUE if the pidl parameter is NULL or the ITEMIDLIST structure pointed to by pidl is empty; otherwise FALSE.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)