Método IAppPublisher::GetCategories (shappmgr.h)

  • Artigo

Recupera uma estrutura listando as categorias fornecidas por um editor de aplicativos.

Sintaxe

HRESULT GetCategories(
  [out] APPCATEGORYINFOLIST *pAppCategoryList
);

Parâmetros

[out] pAppCategoryList

Tipo: APPCATEGORYINFOLIST*

Um ponteiro para uma estrutura APPCATEGORYINFOLIST . O membro cCategory dessa estrutura retorna a contagem de categorias com suporte. O membro pCategoryInfo retorna um ponteiro para uma matriz de estruturas APPCATEGORYINFO . Essa matriz contém todas as categorias compatíveis com um editor de aplicativos e deve ser alocada usando CoTaskMemAlloc e liberada usando CoTaskMemFree.

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 aplicativo Adicionar/Remover Programas Painel de Controle passa a ID retornada para uma categoria para o método IAppPublisher::EnumApps para identificar qual categoria deve ser enumerada.

Exemplos

O exemplo a seguir mostra como calcular o tamanho da matriz de estruturas APPCATEGORYINFO retornadas por IAppPublisher::GetCategories.

size_t CategoryListArraySize = sizeof(APPCATEGORYINFO) * pInfoList->cCategory;

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [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 shappmgr.h

Confira também

APPCATEGORYINFO

APPCATEGORYINFOLIST

IAppPublisher