Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |