ILIsEqual function (shlobj_core.h)

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)