IAppPublisher ::GetCategories, méthode (shappmgr.h)
Récupère une structure répertoriant les catégories fournies par un éditeur d’application.
Syntaxe
HRESULT GetCategories(
[out] APPCATEGORYINFOLIST *pAppCategoryList
);
Paramètres
[out] pAppCategoryList
Type : APPCATEGORYINFOLIST*
Pointeur vers une structure APPCATEGORYINFOLIST . Le membre cCategory de cette structure retourne le nombre de catégories prises en charge. Le membre pCategoryInfo retourne un pointeur vers un tableau de structures APPCATEGORYINFO . Ce tableau contient toutes les catégories prises en charge par un éditeur d’application et doit être alloué à l’aide de CoTaskMemAlloc et libéré à l’aide de CoTaskMemFree.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
L’application Add/Remove Programs Panneau de configuration transmet l’ID retourné pour une catégorie à la méthode IAppPublisher ::EnumApps pour identifier la catégorie à énumérer.
Exemples
L’exemple suivant montre comment calculer la taille du tableau de structures APPCATEGORYINFO retourné par IAppPublisher ::GetCategories.
size_t CategoryListArraySize = sizeof(APPCATEGORYINFO) * pInfoList->cCategory;
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shappmgr.h |