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 |