自訂動作類型 19

此自訂動作會顯示指定的錯誤訊息、傳回失敗，然後終止安裝。 顯示的錯誤訊息可以當做字串或索引提供給 Error 資料表。

來源

將 CustomAction 資料表 的 [來源] 資料行保留空白。

類型值

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

常數	十六進位	Decimal
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile	0x013	19

 

目標

CustomAction 資料表的 [目標] 資料行包含使用MsiFormatRecord (中指定的功能格式化的文字字串，而不需要數值欄位規範) 。 要取代的參數會以方括弧括住、[...]，而且可能是屬性、環境變數 (% 前置詞) 、檔案路徑 (# 前置詞) ，或 ($ 前置詞) 的元件目錄路徑。 如果在格式化字串後評估為整數，該整數會當做索引使用到 Error 資料表 ，以擷取要顯示的訊息。 如果在格式化字串之後包含非數值字元，字串本身會顯示為訊息。

傳回處理選項

自訂動作不會使用任何選項。

執行排程選項

自訂動作不會使用任何選項。

In-Script執行選項

自訂動作不會使用任何選項。

傳回值

請參閱 自訂動作傳回值。

備註

例如，自訂動作 CAError1、CAError2、CAError3 和 CAError4 會傳回這些訊息。

CustomAction 資料表

動作	類型	來源	目標
CAError1	19		[Prop1]
CAError2	19		安裝失敗，因為錯誤 2。
CAError3	19		25000
CAError4	19		[Prop2]

 

屬性工作表

屬性	值
Prop1	「因為錯誤 1 而導致安裝失敗」。
Prop2	"25100"

 

錯誤資料表

程式碼	訊息
25000	安裝失敗，因為錯誤 3。
25100	安裝失敗，因為錯誤 4。

 

這些自訂動作會傳回下列錯誤訊息：

自訂動作	傳回的訊息字串
CAError1	安裝失敗，因為 Error1。
CAError2	安裝失敗，因為錯誤 2。
CAError3	安裝失敗，因為錯誤 3。
CAError4	安裝失敗，因為錯誤 4。

 

請注意，由於撰寫 LaunchCondition 資料表無法保證評估發射條件的順序，因此您應該在安裝中使用自訂動作類型 19 自訂動作，以特定順序評估條件。

相關主題

Custom_Actions