Метод IAppPublisher::GetCategories (shappmgr.h)
Извлекает структуру со списком категорий, предоставляемых издателем приложения.
Синтаксис
HRESULT GetCategories(
[out] APPCATEGORYINFOLIST *pAppCategoryList
);
Параметры
[out] pAppCategoryList
Тип: APPCATEGORYINFOLIST*
Указатель на структуру APPCATEGORYINFOLIST . Элемент cCategory этой структуры возвращает количество поддерживаемых категорий. Элемент pCategoryInfo возвращает указатель на массив структур APPCATEGORYINFO . Этот массив содержит все категории, поддерживаемые издателем приложения, и должен быть выделен с помощью CoTaskMemAlloc и освобожден с помощью CoTaskMemFree.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Приложение панель управления добавления и удаления программ передает идентификатор, возвращенный для категории, методу IAppPublisher::EnumApps, чтобы определить, какая категория должна быть перечислена.
Примеры
В следующем примере показано, как вычислить размер массива структур APPCATEGORYINFO , возвращаемых IAppPublisher::GetCategories.
size_t CategoryListArraySize = sizeof(APPCATEGORYINFO) * pInfoList->cCategory;
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shappmgr.h |