Método IAppPublisher::GetCategories (shappmgr.h)
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 |