MsiSequence

[This is preliminary documentation and subject to change.]

The MsiSequence function executes another action sequence, as described in the specified table.

UINT MsiSequence(
  MSIHANDLE hInstall,    // installer handle
  LPCTSTR szTable,       // table name
  INT iSequenceMode      // processing option
);
 

Parameters

hInstall

Handle to the installation.

szTable

Specifies the name of the table containing the action sequence.

iSequenceMode

Specifies the sequence mode.

Return Values

ERROR_FUNCTION_FAILED

The function failed.

ERROR_FUNCTION_NOT_CALLED

The function was not called.

ERROR_INSTALL_FAILURE

An installation failure occurred.

ERROR_INSTALL_SUSPEND

The installation was suspended.

ERROR_INSTALL_USEREXIT

The user exited the installation.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_HANDLE_STATE

An invalid handle state occurred.

ERROR_INVALID_PARAMETER

An invalid parameter was passed to the function.

ERROR_SUCCESS

The function succeeded.

Remarks

The MsiSequence function queries the specified table, ordering the actions by the numbers in the Sequence column. For each row retrieved, an action is executed, provided that any supplied condition expression does not evaluate to FALSE.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msiquery.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Database Access Reference, Installer Action Functions