GetManagedApplications, fonction (appmgmt.h)
La fonction GetManagedApplications obtient la liste des applications affichées dans le volet Ajouter/Supprimer des programmes (ARP) pour un contexte utilisateur spécifié.
Syntaxe
DWORD GetManagedApplications(
[in] GUID *pCategory,
[in] DWORD dwQueryFlags,
[in] DWORD dwInfoLevel,
[out] LPDWORD pdwApps,
[out] PMANAGEDAPPLICATION *prgManagedApps
);
Paramètres
[in] pCategory
Pointeur vers un GUID qui spécifie la catégorie
des applications à répertorier. Si pCategory n’est pas null, dwQueryFlags doit contenir MANAGED_APPS_FROMCATEGORY. Si pCategory a la valeur Null, dwQueryFlags ne peut pas contenir MANAGED_APPS_FROMCATEGORY.
[in] dwQueryFlags
Ce paramètre peut contenir une ou plusieurs des valeurs suivantes.
MANAGED_APPS_USERAPPLICATIONS
Listes toutes les applications qui s’appliquent à l’utilisateur. Le paramètre pCategory doit être null.
MANAGED_APPS_FROMCATEGORY
Listes uniquement les applications dans la catégorie spécifiée par pCategory. Le paramètre pCategory ne peut pas être null.
[in] dwInfoLevel
Ce paramètre doit être MANAGED_APPS_INFOLEVEL_DEFAULT.
[out] pdwApps
Nombre d’applications dans la liste retournée par cette fonction.
[out] prgManagedApps
Ce paramètre est un pointeur vers un tableau de structures MANAGEDAPPLICATION . Ce tableau contient la liste des applications répertoriées dans le volet Ajouter / Supprimer des programmes (ARP). Vous devez appeler LocalFree pour libérer le tableau lorsqu’il n’est plus nécessaire.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système ou le fichier d’en-tête WinError.h.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | appmgmt.h |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |