Compartilhar via


Função GetManagedApplications (appmgmt.h)

A função GetManagedApplications obtém uma lista de aplicativos exibidos no painel Adicionar de Adicionar/Remover Programas (ARP) para um contexto de usuário especificado.

Sintaxe

DWORD GetManagedApplications(
  [in]  GUID                *pCategory,
  [in]  DWORD               dwQueryFlags,
  [in]  DWORD               dwInfoLevel,
  [out] LPDWORD             pdwApps,
  [out] PMANAGEDAPPLICATION *prgManagedApps
);

Parâmetros

[in] pCategory

Um ponteiro para um GUID que especifica a categoria

de aplicativos a serem listados. Se pCategory não for nulo, dwQueryFlags deverá conter MANAGED_APPS_FROMCATEGORY. Se pCategory for nulo, dwQueryFlags não poderá conter MANAGED_APPS_FROMCATEGORY.

[in] dwQueryFlags

Esse parâmetro pode conter um ou mais dos valores a seguir.

MANAGED_APPS_USERAPPLICATIONS

Listas todos os aplicativos que se aplicam ao usuário. O parâmetro pCategory deve ser nulo.

MANAGED_APPS_FROMCATEGORY

Listas somente aplicativos na categoria especificada por pCategory. O parâmetro pCategory não pode ser nulo.

[in] dwInfoLevel

Esse parâmetro deve ser MANAGED_APPS_INFOLEVEL_DEFAULT.

[out] pdwApps

A contagem de aplicativos na lista retornada por essa função.

[out] prgManagedApps

Esse parâmetro é um ponteiro para uma matriz de estruturas MANAGEDAPPLICATION . Essa matriz contém a lista de aplicativos listados no painel Adicionar de Adicionar/Remover Programas (ARP). Você deve chamar LocalFree para liberar a matriz quando elas não forem mais necessárias.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS. Caso contrário, a função retornará um dos códigos de erro do sistema. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema ou o arquivo de cabeçalho WinError.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho appmgmt.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Funções Política de Grupo

Visão geral da Política de Grupo