IShellItem::Compare method (shobjidl_core.h)

Compares two IShellItem objects.

Syntax

HRESULT Compare(
  IShellItem *psi,
  SICHINTF   hint,
  int        *piOrder
);

Parameters

psi

Type: IShellItem*

A pointer to an IShellItem object to compare with the existing IShellItem object.

hint

Type: SICHINTF

One of the SICHINTF values that determines how to perform the comparison. See SICHINTF for the list of possible values for this parameter.

piOrder

Type: int*

This parameter receives the result of the comparison. If the two items are the same this parameter equals zero; if they are different the parameter is nonzero.

Return value

Type: HRESULT

Returns S_OK if the items are the same, S_FALSE if they are different, or an error value otherwise.

Remarks

The data type used in the second parameter, SICHINTF, is defined as:

typedef DWORD SICHINTF;

Requirements

Requirement Value
Minimum supported client Windows XP with SP1 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 6.0 or later)

See also

IShellFolder

IShellItem