Función MsiDoActionA (msiquery.h)
La función MsiDoAction ejecuta una acción integrada, una acción personalizada o una acción del asistente de interfaz de usuario.
Sintaxis
UINT MsiDoActionA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szAction
);
Parámetros
[in] hInstall
Controle la instalación proporcionada a una acción personalizada de DLL o obtenida a través de MsiOpenPackage, MsiOpenPackageExo MsiOpenProduct.
[in] szAction
Especifica la acción que se va a ejecutar.
Valor devuelto
Esta función devuelve UINT.
Observaciones
La función MsiDoAction ejecuta la acción que corresponde al nombre proporcionado. Si el instalador no reconoce el nombre como una acción integrada o como una acción personalizada en la tabla CustomAction, el nombre se pasa al objeto controlador de interfaz de usuario, que puede invocar una función o un cuadro de diálogo. Si se proporciona un nombre de acción NULL, el instalador usa el valor en mayúsculas del action propiedad como acción que se va a realizar. Si no se define ningún valor de propiedad, se realiza la acción predeterminada, definida como "INSTALL".
Las acciones que actualizan el sistema, como las acciones de InstallFiles y WriteRegistryValues, no se pueden ejecutar llamando a MsiDoAction. La excepción a esta regla es si se llama a MsiDoAction desde una acción personalizada programada en la tabla InstallExecuteSequence entre la InstallInitialize y acciones InstallFinalize. Se puede llamar a acciones que no actualizan el sistema, como appSearch o CostInitialize.
Nota
El encabezado msiquery.h define MsiDoAction 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. Windows Installer en Windows Server 2003 o Windows XP |
| de la plataforma de destino de |
Windows |
| encabezado de |
msiquery.h |
| biblioteca de |
Msi.lib |
| DLL de |
Msi.dll |