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 函式會查詢指定的數據表,並依 Sequence 資料行中的數位排序動作。 針對擷取的每個數據列,會執行動作,前提是任何提供的條件表達式都不會評估為 FALSE。
動作序列,包含更新系統的任何動作,例如 InstallFiles 和 WriteRegistryValues 動作,無法 藉由呼叫 msiSequence來執行。 此規則的例外狀況是,如果 MsiSequence 是從 InstallExecuteSequence 數據表中排程的自定義動作呼叫,InstallInitialize 和 InstallFinalize 動作。 您可以呼叫未更新系統的動作,例如 AppSearch 或 CostInitialize。
注意
msiquery.h 標頭會將 MsiSequence 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer |
目標平臺 | 窗戶 |
標頭 | msiquery.h |
連結庫 | Msi.lib |
DLL | Msi.dll |