IShellFolder::CompareIDs
[Now
Supported on Windows NT]
Determines
the relative ordering of two file objects or folders, given their item
identifier lists.
HRESULT CompareIDs(
|
LPARAM lParam, |
// Type of
comparison to perform |
|
LPCITEMIDLIST pidl1, |
// Address
of ITEMIDLIST structure |
|
LPCITEMIDLIST pidl2 |
// Address
of ITEMIDLIST structure |
|
); |
|
Parameters
lParam
Value
specifying the type of comparison to perform. The calling application should
always specify zero, indicating that the two items should be sorted by name.
pidl1 and pidl2
Addresses of
two ITEMIDLIST
structures that uniquely identify the items to be compared. Both item
identifier lists are relative to the parent folder.
Return Values
Returns a
handle to a result code. If this method is successful, the CODE field of the
status code (SCODE) has the following meaning:
|
CODE field |
Meaning |
|
Less than
zero |
The first
item should precede the second (pidl1 < pidl2). |
|
Greater
than zero |
The first item
should follow the second (pidl1 > pidl2) |
|
Zero |
The two
items are the same (pidl1 = pidl2). |
Remarks
Passing 0 as
the lParam indicates sort by name. 0x00000001-0x7fffffff are for folder
specific sorting rules. 0x80000000-0xfffffff are used the system.
See Also