自訂動作類型 19
此自訂動作會顯示指定的錯誤訊息、傳回失敗，然後終止安裝。 顯示的錯誤訊息可以當做字串或索引提供給 Error 資料表。
來源
將 CustomAction 資料表 的 [來源] 資料行保留空白。
類型值
在 CustomAction 資料表的 Type 資料行中包含下列值，以指定基本數數值型別。
| 常數 | 十六進位 | Decimal |
|---|---|---|
| msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile | 0x013 | 19 |
目標
CustomAction 資料表的 [目標] 資料行包含使用MsiFormatRecord (中指定的功能格式化的文字字串，而不需要數值欄位規範) 。 要取代的參數會以方括弧括住、[...]，而且可能是屬性、環境變數 (% 前置詞) 、檔案路徑 (# 前置詞) ，或 ($ 前置詞) 的元件目錄路徑。 如果在格式化字串後評估為整數，該整數會當做索引使用到 Error 資料表 ，以擷取要顯示的訊息。 如果在格式化字串之後包含非數值字元，字串本身會顯示為訊息。
傳回處理選項
自訂動作不會使用任何選項。
執行排程選項
自訂動作不會使用任何選項。
In-Script執行選項
自訂動作不會使用任何選項。
傳回值
請參閱 自訂動作傳回值。
備註
例如，自訂動作 CAError1、CAError2、CAError3 和 CAError4 會傳回這些訊息。
| 動作 | 類型 | 來源 | 目標 |
|---|---|---|---|
| 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 自訂動作，以特定順序評估條件。
相關主題