GetManagedApplications-Funktion (appmgmt.h)
Die GetManagedApplications-Funktion ruft eine Liste der Anwendungen ab, die im Bereich Hinzufügen von Software (ARP) für einen angegebenen Benutzerkontext angezeigt werden.
Syntax
DWORD GetManagedApplications(
[in] GUID *pCategory,
[in] DWORD dwQueryFlags,
[in] DWORD dwInfoLevel,
[out] LPDWORD pdwApps,
[out] PMANAGEDAPPLICATION *prgManagedApps
);
Parameter
[in] pCategory
Ein Zeiger auf eine GUID, die die Kategorie angibt.
der zu listenden Anwendungen. Wenn pCategory nicht NULL ist, muss dwQueryFlagsMANAGED_APPS_FROMCATEGORY enthalten. Wenn pCategory NULL ist, kann dwQueryFlags keine MANAGED_APPS_FROMCATEGORY enthalten.
[in] dwQueryFlags
Dieser Parameter kann einen oder mehrere der folgenden Werte enthalten.
MANAGED_APPS_USERAPPLICATIONS
Listen alle Anwendungen, die für den Benutzer gelten. Der Parameter pCategory muss NULL sein.
MANAGED_APPS_FROMCATEGORY
Listen nur Anwendungen in der von pCategory angegebenen Kategorie. Der pCategory-Parameter darf nicht NULL sein.
[in] dwInfoLevel
Dieser Parameter muss MANAGED_APPS_INFOLEVEL_DEFAULT sein.
[out] pdwApps
Die Anzahl der Anwendungen in der Liste, die von dieser Funktion zurückgegeben wird.
[out] prgManagedApps
Dieser Parameter ist ein Zeiger auf ein Array von MANAGEDAPPLICATION-Strukturen . Dieses Array enthält die Liste der Anwendungen, die im Bereich Hinzufügen von Software (ARP) aufgeführt sind. Sie müssen LocalFree aufrufen, um das Array frei zu geben, wenn das Array nicht mehr benötigt wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS. Andernfalls gibt die Funktion einen der Systemfehlercodes zurück. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes oder in der Headerdatei WinError.h.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | appmgmt.h |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |