共用方式為

自定義動作類型 19

  • 發行項

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

源

將 CustomAction 數據表的 Source 數據行保留空白。

類型值

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

常數 十六進位 十進位
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 安裝失敗，因為錯誤 1。
CAError2 安裝失敗，因為錯誤 2。
CAError3 安裝失敗，因為錯誤 3。
CAError4 安裝失敗，因為錯誤 4。

 

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

Custom_Actions