Função UninstallApplication (appmgmt.h)

A função UninstallApplication desinstala um aplicativo de política de grupo que manipula a instalação e a instalação usando arquivos .msi do Windows Installer . A função UninstallApplication só deve ser chamada no contexto do usuário para o qual o aplicativo de política de grupo de usuários tentou anteriormente uma desinstalação chamando a função MsiConfigureProduct . A função InstallApplication pode instalar aplicativos de política de grupo.

Nota A falha ao chamar UninstallApplication como parte do protocolo para desinstalar um aplicativo baseado em política de grupo pode fazer com que o RSoP (Conjunto resultante de política) indique informações imprecisas.

 

Sintaxe

DWORD UninstallApplication(
  [in] LPWSTR ProductCode,
  [in] DWORD  dwStatus
);

Parâmetros

[in] ProductCode

O código do produto windows installer do produto que está sendo desinstalado. O código do produto do aplicativo deve ser fornecido na forma de um GUID do Windows Installer como uma cadeia de caracteres com chaves.

[in] dwStatus

O status da tentativa de desinstalação. O parâmetro dwStatus é o código de sucesso do Windows da tentativa de desinstalação retornada por MsiConfigureProduct. O sistema pode usar isso para garantir que o RSoP (Conjunto resultante de política) indique se a desinstalação falhou ou teve êxito.

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

Remova um aplicativo de política de grupo que usa 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.

Remova os aplicativos instalados usando as configurações de instalação de software (arquivos.zap) chamando a função de desinstalação ou o 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

Confira também

Funções Política de Grupo

Visão geral da Política de Grupo

InstallApplication

MsiConfigureProduct