GetLocalManagedApplications-Funktion (appmgmt.h)
Die GetLocalManagedApplications-Funktion kann auf dem Zielcomputer ausgeführt werden, um eine Liste der verwalteten Anwendungen auf diesem Computer abzurufen. Die Funktion kann auch im Kontext eines Benutzers aufgerufen werden, um eine Liste der verwalteten Anwendungen für diesen Benutzer abzurufen. Diese Funktion gibt nur Anwendungen zurück, die vom Windows Installer installiert werden können.
Syntax
DWORD GetLocalManagedApplications(
[in] BOOL bUserApps,
[out] LPDWORD pdwApps,
[out] PLOCALMANAGEDAPPLICATION *prgLocalApps
);
Parameter
[in] bUserApps
Ein Wert, der bei TRUE der prgLocalApps-Parameter eine Liste der verwalteten Anwendungen enthält, die für den Benutzer gilt. Wenn der Wert dieses Parameters FALSE ist, enthält der PrgLocalApps-Parameter eine Liste verwalteter Anwendungen, die für den lokalen Computer gilt.
[out] pdwApps
Die Adresse eines DWORD-Werts , der die Anzahl der Anwendungen in der Liste angibt, die von prgLocalApps zurückgegeben werden.
[out] prgLocalApps
Die Adresse eines Arrays, das die Liste der verwalteten Anwendungen enthält. Sie müssen LocalFree aufrufen, um dieses Array frei zu geben, wenn dessen Inhalt nicht mehr benötigt wird. Dieser Parameter darf nicht NULL sein. Die Liste wird als LOCALMANAGEDAPPLICATION-Struktur zurückgegeben.
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 |