ILIsEqual function (shlobj_core.h)

2024-02-22

Tests whether two ITEMIDLIST structures are equal in a binary comparison.

Syntax

BOOL ILIsEqual(
  [in] PCIDLIST_ABSOLUTE pidl1,
  [in] PCIDLIST_ABSOLUTE pidl2
);

Parameters

[in] pidl1

Type: PCIDLIST_ABSOLUTE

The first ITEMIDLIST structure.

[in] pidl2

Type: PCIDLIST_ABSOLUTE

The second ITEMIDLIST structure.

Return value

Type: BOOL

Returns TRUE if the two structures are equal, FALSE otherwise.

Remarks

ILIsEqual performs a binary comparison of the item data. It is possible for two ITEMIDLIST structures to differ at the binary level while referring to the same item. IShellFolder::CompareIDs should be used to perform a non-binary comparison.

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)