Método ICategoryProvider::EnumCategories (shobjidl_core.h)

Obtém o enumerador para a lista de GUIDs que representam categorias.

Sintaxe

HRESULT EnumCategories(
  [out] IEnumGUID **penum
);

Parâmetros

[out] penum

Tipo: IEnumGUID**

Quando esse método retorna, contém o endereço de um ponteiro para uma interface IEnumGUID que especifica uma lista de GUIDs que representam categorias.

Valor retornado

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

No caso do objeto de exibição de pasta do sistema, ICategoryProvider::EnumCategories é usado para obter categorias adicionais que não estão associadas a uma coluna. Quando a lista de GUIDs de categoria é retornada por meio de penum, a interface do usuário tenta recuperar o nome de cada categoria. Esse nome é exibido como uma opção de categoria. No caso do Windows XP, essa opção aparece no menu Organizar Ícones por da pasta.

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