IAppPublisher::GetCategories-Methode (shappmgr.h)

Ruft eine Struktur ab, die die von einem Anwendungsherausgeber bereitgestellten Kategorien auflistet.

Syntax

HRESULT GetCategories(
  [out] APPCATEGORYINFOLIST *pAppCategoryList
);

Parameter

[out] pAppCategoryList

Typ: APPCATEGORYINFOLIST*

Ein Zeiger auf eine APPCATEGORYINFOLIST-Struktur . Das cCategory-Element dieser Struktur gibt die Anzahl der unterstützten Kategorien zurück. Das pCategoryInfo-Element gibt einen Zeiger auf ein Array von APPCATEGORYINFO-Strukturen zurück. Dieses Array enthält alle Kategorien, die von einem Anwendungsherausgeber unterstützt werden, und muss mithilfe von CoTaskMemAlloc zugeordnet und mithilfe von CoTaskMemFree freigegeben werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Systemsteuerung Anwendung zum Hinzufügen/Entfernen von Programmen übergibt die für eine Kategorie zurückgegebene ID an die IAppPublisher::EnumApps-Methode, um zu ermitteln, welche Kategorie aufgezählt werden soll.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Größe des Arrays von APPCATEGORYINFO-Strukturen berechnet wird, das von IAppPublisher::GetCategories zurückgegeben wird.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shappmgr.h

Weitere Informationen

APPCATEGORYINFO

APPCATEGORYINFOLIST

IAppPublisher