Функция 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

См. также раздел

Функции групповая политика

Обзор групповых политик