Méthode ICategorizer::CompareCategory (shobjidl_core.h)

Détermine l’ordre relatif de deux éléments dans leurs listes d’identificateurs d’éléments, et donc dans l’interface utilisateur.

Syntaxe

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

Paramètres

csfFlags

Type : CATSORT_FLAGS

Indicateur qui spécifie la façon dont la comparaison doit être effectuée. Le paramètre doit être l’une des valeurs de CATSORT_FLAGS.

dwCategoryId1

Type : DWORD

DWORD qui spécifie l’identificateur de première catégorie à utiliser dans la comparaison.

dwCategoryId2

Type : DWORD

DWORD qui spécifie l’identificateur de deuxième catégorie à utiliser dans la comparaison.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, le champ CODE du HRESULT contient une valeur qui spécifie le résultat de la comparaison. Sinon, elle retourne un code d’erreur COM.

Remarques

Le tableau suivant montre les valeurs retournées dans le champ CODE du HRESULT.

Inférieure à zéro	Le premier élément doit précéder le second (dwCategoryId1<dwCategoryId2).
Supérieure à zéro	Le premier élément doit suivre le deuxième (dwCategoryId1>dwCategoryId2).
Zéro	Les deux éléments sont identiques (dwCategoryId1 = dwCategoryId2).

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll