Condividi tramite


Metodo IAppPublisher::GetCategories (shappmgr.h)

Recupera una struttura che elenca le categorie fornite da un server di pubblicazione dell'applicazione.

Sintassi

HRESULT GetCategories(
  [out] APPCATEGORYINFOLIST *pAppCategoryList
);

Parametri

[out] pAppCategoryList

Tipo: APPCATEGORYINFOLIST*

Puntatore a una struttura APPCATEGORYINFOLIST . Il membro cCategory di questa struttura restituisce il conteggio delle categorie supportate. Il membro pCategoryInfo restituisce un puntatore a una matrice di strutture APPCATEGORYINFO . Questa matrice contiene tutte le categorie supportate da un server di pubblicazione di applicazioni e deve essere allocata usando CoTaskMemAlloc e liberata usando CoTaskMemFree.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il metodo Add/Remove Programs Pannello di controllo Application passa l'ID restituito per una categoria al metodo IAppPublisher::EnumApps per identificare la categoria da enumerare.

Esempio

Nell'esempio seguente viene illustrato come calcolare le dimensioni della matrice di strutture APPCATEGORYINFOrestituite da IAppPublisher::GetCategories.

size_t CategoryListArraySize = sizeof(APPCATEGORYINFO) * pInfoList->cCategory;

Requisiti

Requisito Valore
Client minimo supportato Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shappmgr.h

Vedi anche

APPCATEGORYINFO

APPCATEGORYINFOLIST

IAppPublisher