Función MsiInstallProductA (msi.h)
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. Para más información, consulte Sobre propiedades.
Para realizar una instalación administrativa, incluya ACTION=ADMIN en szCommandLine. Para obtener más información, consulte la propiedad ACTION.
Valor devuelto
| Valor | Significado |
|---|---|
|
La función se completa correctamente. |
|
Para más información, consulte Códigos de error. |
| Error relacionado con la inicialización. |
Para obtener más información, vea Mensajes de error mostrados.
Comentarios
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 las funciones MsiSetInternalUI, MsiSetExternalUI o MsiSetExternalUIRecord .
- Puede establecer el modo de registro mediante la función MsiEnableLog .
- Puede quitar completamente un producto estableciendo REMOVE=ALL en szCommandLine.
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 Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | 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 Requisitos de Windows Installer en tiempo de ejecución para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer. |
| Plataforma de destino | Windows |
| Encabezado | msi.h |
| Library | Msi.lib |
| Archivo DLL | Msi.dll |