Función MsiSequenceA (msiquery.h)

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

Sintaxis

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

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

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

[in] iSequenceMode

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

Valor devuelto

Esta función devuelve UINT.

Comentarios

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

Una secuencia de acciones que contenga acciones que actualicen el sistema, como las acciones InstallFiles y WriteRegistryValues , no se pueden ejecutar mediante una llamada 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 las acciones InstallInitialize e 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
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. Windows Installer en Windows Server 2003 o Windows XP
Plataforma de destino	Windows
Encabezado	msiquery.h
Library	Msi.lib
Archivo DLL	Msi.dll

Consulte también

Funciones de acción del instalador