Función InstallApplication (appmgmt.h)
La función InstallApplication puede instalar aplicaciones que se han implementado para los usuarios de destino que pertenecen a un dominio. El contexto de seguridad del usuario que llama a InstallApplication debe ser el de un usuario de dominio que ha iniciado sesión en un equipo de un dominio que confíe en el dominio del usuario de destino. directiva de grupo se debe aplicar correctamente cuando el usuario de destino inicia sesión.
Sintaxis
DWORD InstallApplication(
[in] PINSTALLDATA pInstallInfo
);
Parámetros
[in] pInstallInfo
Puntero a una estructura INSTALLDATA que especifica la aplicación que se va a instalar.
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
La función InstallApplication solo puede instalar aplicaciones que se han implementado mediante directiva de grupo. Un administrador de dominio puede implementar aplicaciones para los usuarios de destino mediante la sección de configuración de usuario de directiva de grupo Objects (GPO). El usuario de destino debe pertenecer al dominio de destino y el GPO debe aplicarse a este usuario en el dominio de destino. La función InstallApplication instala aplicaciones según las reglas de herencia de directiva de grupo estándar. Si la misma aplicación se implementa en varios GPO, la función instala la versión de la aplicación implementada en el GPO de precedencia más alta. Una vez instalada una aplicación para un usuario, no es visible para otros usuarios del equipo. Esto es estándar para las aplicaciones que se implementan a través de la directiva de grupo de usuarios.
La función InstallApplication puede instalar aplicaciones implementadas que usan Windows Installer (archivos .msi) o la configuración de instalación de software (archivos .zap) para controlar la instalación y la instalación.
La función InstallApplication puede instalar aplicaciones que usan un paquete de Windows Installer para su instalación. En este caso, no es necesario que el usuario que llama a InstallApplication tenga privilegios de administrador. El sistema puede instalar la aplicación porque Windows Installer es una aplicación de confianza implementada por un administrador de dominio. El usuario que recibe la aplicación debe tener acceso a la ubicación de los archivos .msi.
Quite las aplicaciones instaladas mediante archivos .msi 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.
La función InstallApplication también puede instalar aplicaciones que usan aplicaciones de instalación basadas en la configuración de instalación de software (archivos .zap). El usuario que recibe la aplicación debe tener acceso a la ubicación de los archivos .zap. Un archivo .zap es un archivo de texto similar a un archivo de .ini, que permite a Windows publicar una aplicación (por ejemplo, Setup.exe) para la instalación con Agregar o quitar programas. Para publicar aplicaciones que no usan Windows Installer, debe crear un archivo .zap, copiar el archivo .zap en los servidores de punto de distribución de software y, a continuación, usar directiva de grupo implementación de software basada en directiva de grupo para publicar la aplicación para los usuarios. Si la aplicación se implementa mediante archivos .zap, el usuario que instala la aplicación debe tener privilegios en el equipo para instalar el software. No se pueden usar archivos .zap para aplicaciones asignadas.
Quite las aplicaciones mediante la configuración de instalación de software (archivos .zap) mediante una llamada a la función de desinstalación o un comando específico para 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 |
| Conjunto de API | ext-ms-win-advapi32-msi-l1-1-0 (introducido en Windows 8) |
Consulte también
Funciones de directiva de grupo