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

Obtém uma lista de categorias associadas a uma lista de identificadores.

Sintaxe

HRESULT GetCategory(
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY apidl,
  [out] DWORD                 *rgCategoryIds
);

Parâmetros

[in] cidl

Tipo: UINT

O número de itens em uma matriz de lista de identificadores de item.

[in] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

Um ponteiro para uma matriz de ponteiros de lista de identificadores de item cidl .

[out] rgCategoryIds

Tipo: DWORD*

Quando esse método retorna, contém um ponteiro para uma matriz de identificadores de categoria cidl .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O método ICategorizer::GetCategory aceita uma matriz de ponteiros para PIDLs (listas de identificadores de item) e preenche uma matriz de identificadores de categoria.

Importante O valor -1 é um identificador de categoria inválido.

 

Requisitos

Requisito	Valor
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