ICategorizer::CompareCategory-Methode (shobjidl_core.h)

  • Artikel

Bestimmt die relative Reihenfolge von zwei Elementen in ihren Elementbezeichnerlisten und somit in der Benutzeroberfläche.

Syntax

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

Parameter

csfFlags

Typ: CATSORT_FLAGS

Ein Flag, das angibt, wie der Vergleich durchgeführt werden soll. Der Parameter sollte einer der Werte in CATSORT_FLAGS sein.

dwCategoryId1

Art: DWORD

Ein DWORD , das den ersten Kategoriebezeichner angibt, der im Vergleich verwendet werden soll.

dwCategoryId2

Art: DWORD

Ein DWORD , das den zweiten Kategoriebezeichner angibt, der im Vergleich verwendet werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, enthält das FELD CODE des HRESULT einen Wert, der das Ergebnis des Vergleichs angibt. Andernfalls wird ein COM-Fehlercode zurückgegeben.

Hinweise

In der folgenden Tabelle sind die im Feld CODE des HRESULT zurückgegebenen Werte aufgeführt.

Kleiner als 0 (null) Das erste Element sollte dem zweiten (dwCategoryId1<dwCategoryId2) vorangehen.
Größer als 0 (null) Das erste Element sollte auf das zweite (dwCategoryId1>dwCategoryId2) folgen.
Null Die beiden Elemente sind identisch (dwCategoryId1 = dwCategoryId2).

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll