Função InstallApplication (appmgmt.h)
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 InstallerMsiConfigureProduct 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) |
Confira também
Visão geral da Política de Grupo