Функция GetManagedApplications (appmgmt.h)
Функция GetManagedApplications получает список приложений, которые отображаются на панели Добавление элемента Add/Remove Programs (ARP) для указанного пользовательского контекста.
Синтаксис
DWORD GetManagedApplications(
[in] GUID *pCategory,
[in] DWORD dwQueryFlags,
[in] DWORD dwInfoLevel,
[out] LPDWORD pdwApps,
[out] PMANAGEDAPPLICATION *prgManagedApps
);
Параметры
[in] pCategory
Указатель на GUID, указывающий категорию
приложений, которые будут перечислены. Если значение pCategory не равно NULL, dwQueryFlags должно содержать MANAGED_APPS_FROMCATEGORY. Если pCategory имеет значение NULL, dwQueryFlags не может содержать MANAGED_APPS_FROMCATEGORY.
[in] dwQueryFlags
Этот параметр может содержать одно или несколько из следующих значений.
MANAGED_APPS_USERAPPLICATIONS
Списки все приложения, которые применяются к пользователю. Параметр pCategory должен иметь значение NULL.
MANAGED_APPS_FROMCATEGORY
Списки только приложения в категории, указанной параметром pCategory. Параметр pCategory не может иметь значение NULL.
[in] dwInfoLevel
Этот параметр должен быть MANAGED_APPS_INFOLEVEL_DEFAULT.
[out] pdwApps
Число приложений в списке, возвращаемом этой функцией.
[out] prgManagedApps
Этот параметр является указателем на массив структур MANAGEDAPPLICATION . Этот массив содержит список приложений, перечисленных на панели Добавление в разделе Установка и удаление программ (ARP). Необходимо вызвать Метод LocalFree , чтобы освободить массив, когда массив больше не требуется.
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение будет ERROR_SUCCESS. В противном случае функция возвращает один из кодов системных ошибок. Полный список кодов ошибок см. в разделе Системные коды ошибок или в файле заголовка WinError.h.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | appmgmt.h |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |