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

Статья
11/20/2024

Функция 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
целевая платформа	Виндоус
заголовка	msiquery.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

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

Поделиться через