Поделиться через


Метод 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

См. также раздел

APPCATEGORYINFO

APPCATEGORYINFOLIST

IAppPublisher