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

Determina a ordem relativa de dois itens em suas listas de identificadores de item e, portanto, na interface do usuário.

Sintaxe

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

Parâmetros

csfFlags

Tipo: CATSORT_FLAGS

Um sinalizador que especifica como a comparação deve ser executada. O parâmetro deve ser um dos valores em CATSORT_FLAGS.

dwCategoryId1

Tipo: DWORD

Um DWORD que especifica o primeiro identificador de categoria a ser usado na comparação.

dwCategoryId2

Tipo: DWORD

Um DWORD que especifica o segundo identificador de categoria a ser usado na comparação.

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, o campo CODE do HRESULT conterá um valor que especifica o resultado da comparação, caso contrário, retornará um código de erro COM.

Comentários

A tabela a seguir mostra os valores retornados no campo CODE do HRESULT.

Menor que zero	O primeiro item deve preceder o segundo (dwCategoryId1<dwCategoryId2).
Maior que zero	O primeiro item deve seguir o segundo (dwCategoryId1>dwCategoryId2).
Zero	Os dois itens são os mesmos (dwCategoryId1 = dwCategoryId2).

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll