Функция MsiSequenceA (msiquery.h)

Функция MsiSequence выполняет другую последовательность действий, как описано в указанной таблице.

Синтаксис

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

Параметры

[in] hInstall

Дескриптор установки, предоставленной пользовательскому действию DLL или полученной через MsiOpenPackage, MsiOpenPackageEx или MsiOpenProduct.

[in] szTable

Указывает имя таблицы, содержащей последовательность действий.

[in] iSequenceMode

Этот параметр в настоящее время не реализован. Он зарезервирован для использования в будущем и должен иметь значение 0.

Возвращаемое значение

Эта функция возвращает UINT.

Комментарии

Функция MsiSequence запрашивает указанную таблицу, упорядочивая действия по числам в столбце Последовательность. Для каждой полученной строки выполняется действие при условии, что любое предоставленное выражение условия не принимает значение FALSE.

Последовательность действий, содержащая любые действия, которые обновляют систему, такие как действия InstallFiles и WriteRegistryValues , не может выполняться путем вызова MsiSequence. Исключением из этого правила является вызов MsiSequence из настраиваемого действия, запланированного в таблице InstallExecuteSequence между действиями InstallInitialize и InstallFinalize. Можно вызывать действия, которые не обновляют систему, например AppSearch или CostInitialize.

Примечание

Заголовок msiquery.h определяет MsiSequence в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
Целевая платформа	Windows
Header	msiquery.h
Библиотека	Msi.lib
DLL	Msi.dll

См. также раздел

Функции действий установщика