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

Weitere Informationen

Gruppenrichtlinie-Funktionen

Übersicht über Gruppenrichtlinien

LOCALMANAGEDAPPLICATION