Compartir a través de

Función MsiInstallProductA (msi.h)

  • Artículo

La función MsiInstallProduct instala o desinstala un producto.

Sintaxis

UINT MsiInstallProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szCommandLine
);

Parámetros

[in] szPackagePath

Cadena terminada en null que especifica la ruta de acceso a la ubicación del paquete de Windows Installer. El valor de cadena puede contener una dirección URL (por ejemplo, http://packageLocation/package/package.msi), una ruta de acceso de red (por ejemplo, \packageLocation\package.msi), una ruta de acceso de archivo (por ejemplo, file://packageLocation/package.msi) o una ruta de acceso local (por ejemplo, D:\packageLocation\package.msi).

[in] szCommandLine

Cadena terminada en NULL que especifica la configuración de la propiedad de la línea de comandos. Debe ser una lista del formato Property=Setting Property=Setting Property=Setting. Para obtener más información, vea Acerca de las propiedades.

Para realizar una instalación administrativa, incluya ACTION=ADMIN en szCommandLine. Para obtener más información, consulte la propiedad ACTION de .

Valor devuelto

Valor Significado
ERROR_SUCCESS
 La función se completa correctamente.
Error relacionado con una acción
 Para obtener más información, consulte códigos de error.
error de inicialización
 Error relacionado con la inicialización.
 

Para obtener más información, vea Mensajes de error mostrados.

Observaciones

La función MsiInstallProduct muestra la interfaz de usuario con la configuración actual y el modo de registro.

  • Puede cambiar la configuración de la interfaz de usuario mediante elMsiSetInternalUI , MsiSetExternalUIo funciones de MsiSetExternalUIRecord.
  • Puede establecer el modo de registro mediante la función MsiEnableLog.
  • Puede quitar completamente un producto estableciendo REMOVE=ALL en szCommandLine.
Para obtener más información, vea REMOVE Property.

Nota

El encabezado msi.h define MsiInstallProduct como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Consulte Windows Installer Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de Windows
encabezado de msi.h
biblioteca de Msi.lib
DLL de Msi.dll

Consulte también

mensajes de error mostrados

códigos de error de

error de inicialización

funciones de instalación y configuración

instalaciones de Multiple-Package