Función MsiSequenceA (msiquery.h)

La función msiSequence ejecuta otra secuencia de acciones, tal como se describe en la tabla especificada.

Sintaxis

UINT MsiSequenceA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szTable,
  [in] INT       iSequenceMode
);

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] szTable

Especifica el nombre de la tabla que contiene la secuencia de acciones.

[in] iSequenceMode

Este parámetro está actualmente sin implementar. Está reservado para uso futuro y debe ser 0.

Valor devuelto

Esta función devuelve UINT.

Observaciones

La función MsiSequence consulta la tabla especificada y ordena las acciones por los números de la columna Secuencia. Para cada fila recuperada, se ejecuta una acción, siempre que cualquier expresión de condición proporcionada no se evalúe como FALSE.

No se puede ejecutar una secuencia de acciones que contenga acciones que actualicen el sistema, como el InstallFiles de y las acciones WriteRegistryValues, llamando a MsiSequence. La excepción a esta regla es si se llama a MsiSequence 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 MsiSequence 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

Consulte también

funciones de acción del instalador de