Função InstallApplication (appmgmt.h)

Artigo
03/14/2023

A função InstallApplication pode instalar aplicativos que foram implantados para usuários de destino que pertencem a um domínio. O contexto de segurança do usuário que está chamando InstallApplication deve ser o de um usuário de domínio conectado a um computador em um domínio que confia no domínio do usuário de destino. Política de Grupo deve ser aplicado com êxito quando o usuário de destino faz logon.

Sintaxe

DWORD InstallApplication(
  [in] PINSTALLDATA pInstallInfo
);

Parâmetros

[in] pInstallInfo

Um ponteiro para uma estrutura INSTALLDATA que especifica o aplicativo a ser instalado.

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.

Comentários

A função InstallApplication só pode instalar aplicativos que foram implantados usando Política de Grupo. Um administrador de domínio pode implantar aplicativos para usuários de destino usando a seção de configuração do usuário do GPO (Objetos Política de Grupo). O usuário de destino deve pertencer ao domínio de destino e o GPO deve ser aplicado a esse usuário no domínio de destino. A função InstallApplication instala aplicativos de acordo com as regras de herança de Política de Grupo padrão. Se o mesmo aplicativo for implantado em vários GPOs, a função instalará a versão do aplicativo implantada no GPO de precedência mais alta. Depois que um aplicativo é instalado para um usuário, ele não fica visível para outros usuários no computador. Isso é padrão para aplicativos implantados por meio da política de grupo de usuários.

A função InstallApplication pode instalar aplicativos implantados que usam o Windows Installer (arquivos .msi) ou configurações de instalação de software (arquivos.zap) para lidar com a instalação e instalação.

A função InstallApplication pode instalar aplicativos que usam um pacote do Windows Installer para sua instalação. Nesse caso, o usuário que chama InstallApplication não precisa ter privilégios de administrador. O sistema pode instalar o aplicativo porque o Windows Installer é um aplicativo confiável implantado por um administrador de domínio. O usuário que recebe o aplicativo deve ter acesso ao local dos arquivos .msi.

Remova os aplicativos instalados usando arquivos .msi chamando a função Do Windows Installer MsiConfigureProduct para desinstalar o aplicativo. Em seguida, chame DesinstalarApplication para informar ao sistema que o aplicativo não é mais gerenciado no cliente Política de Grupo. DesinstalarApplication deve ser chamado mesmo que a desinstalação falhe porque isso permite que o sistema mantenha o RSoP (Conjunto resultante de política) preciso.

A função InstallApplication também pode instalar aplicativos que usam aplicativos de instalação com base em configurações de instalação de software (arquivos.zap). O usuário que recebe o aplicativo deve ter acesso ao local dos arquivos .zap. Um arquivo .zap é um arquivo de texto semelhante a um arquivo .ini, que permite que o Windows publique um aplicativo (por exemplo, Setup.exe) para instalação com Adicionar ou Remover Programas. Para publicar aplicativos que não usam o Windows Installer, você deve criar um arquivo .zap, copiar o arquivo .zap para os servidores do ponto de distribuição de software e, em seguida, usar a implantação de software baseada em Política de Grupo para publicar o aplicativo para os usuários. Se o aplicativo for implantado usando arquivos .zap, o usuário que está instalando o aplicativo deverá ter privilégios no computador para instalar o software. Não é possível usar arquivos .zap para aplicativos atribuídos.

Remova aplicativos usando configurações de instalação de software (arquivos.zap) chamando a função de desinstalação ou um comando específico para o aplicativo de instalação.

Para obter informações sobre como usar aplicativos de instalação diferentes do Windows Installer , consulte o artigo 231747, "Como publicar programas não MSI com arquivos .zap", na Base de Dados de Conhecimento da Microsoft.

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
Conjunto de APIs	ext-ms-win-advapi32-msi-l1-1-0 (introduzido em Windows 8)