ICategorizer::CompareCategory method (shobjidl_core.h)

Menentukan urutan relatif dua item dalam daftar pengidentifikasi item mereka, dan karenanya di UI.

Sintaks

HRESULT CompareCategory(
  CATSORT_FLAGS csfFlags,
  DWORD         dwCategoryId1,
  DWORD         dwCategoryId2
);

Parameter

csfFlags

Jenis: CATSORT_FLAGS

Bendera yang menentukan bagaimana perbandingan harus dilakukan. Parameter harus menjadi salah satu nilai dalam CATSORT_FLAGS.

dwCategoryId1

Jenis: DWORD

DWORD yang menentukan pengidentifikasi kategori pertama yang akan digunakan dalam perbandingan.

dwCategoryId2

Jenis: DWORD

DWORD yang menentukan pengidentifikasi kategori kedua untuk digunakan dalam perbandingan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, bidang CODE HRESULT berisi nilai yang menentukan hasil perbandingan, jika tidak, kode kesalahan COM akan dikembalikan.

Keterangan

Tabel berikut ini memperlihatkan nilai yang dikembalikan di bidang CODE HRESULT.

Kurang dari nol	Item pertama harus mendahului yang kedua (dwCategoryId1<dwCategoryId2).
Lebih besar dari nol	Item pertama harus mengikuti yang kedua (dwCategoryId1>dwCategoryId2).
Nol	Dua item tersebut sama (dwCategoryId1 = dwCategoryId2).

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll