Función UninstallApplication (appmgmt.h)
La función UninstallApplication desinstala una aplicación de directiva de grupo que controla la instalación y la instalación mediante windows Installer .msi archivos. La función UninstallApplication solo debe llamarse en el contexto del usuario para el que la aplicación de directiva de grupo de usuarios ha intentado previamente una desinstalación llamando a la función MsiConfigureProduct . La función InstallApplication puede instalar aplicaciones de directiva de grupo.
Sintaxis
DWORD UninstallApplication(
[in] LPWSTR ProductCode,
[in] DWORD dwStatus
);
Parámetros
[in] ProductCode
Código de producto de Windows Installer del producto que se va a desinstalar. El código de producto de la aplicación debe proporcionarse en forma de GUID de Windows Installer como una cadena con llaves.
[in] dwStatus
Estado del intento de desinstalación. El parámetro dwStatus es el código correcto de Windows del intento de desinstalación devuelto por MsiConfigureProduct. El sistema puede usarlo para asegurarse de que el conjunto resultante de directiva (RSoP) indica si la desinstalación ha fallado o se ha realizado correctamente.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS. De lo contrario, la función devuelve uno de los códigos de error del sistema. Para obtener una lista completa de los códigos de error, consulta Códigos de error del sistema o el archivo de encabezado WinError.h.
Comentarios
Quite una aplicación de directiva de grupo que use .msi archivos llamando a la función MsiConfigureProduct de Windows Installer para desinstalar la aplicación. A continuación, llame a UninstallApplication para informar al sistema de que la aplicación ya no se administra en el cliente mediante directiva de grupo. Se debe llamar a UninstallApplication incluso si se produce un error en la desinstalación porque esto permite al sistema mantener el conjunto resultante de directiva (RSoP) preciso.
Quite las aplicaciones instaladas mediante la configuración de instalación de software (archivos .zap) llamando a la función de desinstalación o al comando específico de la aplicación de instalación. Para obtener información sobre el uso de aplicaciones de instalación distintas de Windows Installer , consulte el artículo 231747, "Cómo publicar programas que no son MSI con archivos .zap" en Microsoft Knowledge Base.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | appmgmt.h |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |
Consulte también
Funciones de directiva de grupo