自訂動作類型 1

  • 發行項

此自訂動作會呼叫動態連結程式庫 (DLL) 以 C 或 C++ 撰寫。

來源

DLL 是從暫存二進位資料流程產生。 CustomAction 資料表的 [來源] 欄位包含二進位資料表的索引鍵。

二進位資料表中的 [資料] 資料行包含資料流程資料。 系統會為每個資料列配置個別的資料流程。 您可以使用 MsiRecordSetStream ，後面接著 MsiViewModify ，將記錄插入資料表中，從檔案插入新的二進位資料。 叫用自訂動作時，資料流程資料會複製到暫存檔案，然後根據自訂動作的類型進行處理。

類型值

在 CustomAction 資料表 的 Type 資料行中包含下列旗標位，以指定基本數數值型別。

常數 十六進位 Decimal
msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData 0x001 1

 

目標

DLL 會透過 CustomAction 資料表之 Target 欄位中名為 的進入點呼叫，並傳遞單一引數，該引數是目前安裝會話的控制碼。 資料表中指定的進入點名稱必須符合從 DLL 匯出的進入點名稱。 請注意，如果未指定專案函式，則為 。DEF 檔案或 /EXPORT： 連結器規格，名稱可能有前置底線和 「@4」 尾碼。 呼叫的函式必須指定呼叫慣例__stdcall。

傳回處理選項

在 CustomAction 資料表 的 Type 資料行中包含選擇性旗標位，以指定傳回處理選項。 如需選項和值的描述，請參閱 自訂動作傳回處理選項。

執行排程選項

在 CustomAction 資料表 的 Type 資料行中包含選擇性旗標位，以指定執行排程選項。 這些選項可控制自訂動作的多重執行。 如需選項的描述，請參閱 自訂動作執行排程選項。

In-Script執行選項

在 CustomAction 資料表 的 Type 資料行中包含選擇性旗標位，以指定腳本內執行選項。 這些選項會將動作程式碼複製到執行、復原或認可腳本。 如需選項的描述，請參閱 自訂動作In-Script執行選項。

傳回值

請參閱 自訂動作傳回值。

備註

呼叫動態連結程式庫 (DLL) 的自訂動作需要安裝會話的控制碼。 如果這也是延後執行自訂動作，則會話在執行安裝腳本期間可能已不存在。 如需此類型之自訂動作如何取得內容資訊的資訊，請參閱 取得延後執行自訂動作的內容資訊。

匯出資料庫資料表時，每個資料流程都會以名為 資料表之子資料夾中的個別檔案寫入，並使用主鍵做為二進位資料表 (Name 資料行的檔案名) ，預設副檔名為 「.ibd」。 如果檔案系統或版本控制系統不支援長檔名，則名稱應該使用 8.3 格式。 永續性封存檔案會以所使用的檔案名取代資料流程資料，以便在匯入資料表時找到資料。

Custom_Actions

動態連結程式庫

取得延後執行自訂動作的內容資訊