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

Identificador de la instalación proporcionada a una acción personalizada de DLL o obtenida a través de MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] szAction

Especifica la acción que se va a ejecutar.

Valor devuelto

Esta función devuelve UINT.

Comentarios

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 de 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 de la propiedad ACTION 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 InstallFiles y WriteRegistryValues , no se pueden ejecutar mediante una llamada 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 las acciones InstallInitialize e InstallFinalize. Se puede llamar a acciones que no actualizan el sistema, como AppSearch o CostInitialize.

Requisitos

Consulte también

Funciones de acción del instalador