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.
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 |