Método IAppPublisher::GetCategories (shappmgr.h)
Recupera una estructura que muestra las categorías proporcionadas por un publicador de aplicaciones.
Sintaxis
HRESULT GetCategories(
[out] APPCATEGORYINFOLIST *pAppCategoryList
);
Parámetros
[out] pAppCategoryList
Tipo: APPCATEGORYINFOLIST*
Puntero a una estructura APPCATEGORYINFOLIST . El miembro cCategory de esta estructura devuelve el recuento de categorías admitidas. El miembro pCategoryInfo devuelve un puntero a una matriz de estructuras APPCATEGORYINFO . Esta matriz contiene todas las categorías que admite un publicador de aplicaciones y debe asignarse mediante CoTaskMemAlloc y liberarse mediante CoTaskMemFree.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
La aplicación Add/Remove Programs Panel de control pasa el identificador devuelto para una categoría al método IAppPublisher::EnumApps para identificar qué categoría se va a enumerar.
Ejemplos
En el ejemplo siguiente se muestra cómo calcular el tamaño de la matriz de estructuras APPCATEGORYINFO devueltas por IAppPublisher::GetCategories.
size_t CategoryListArraySize = sizeof(APPCATEGORYINFO) * pInfoList->cCategory;
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shappmgr.h |