自訂動作類型 21

此自訂動作是以 JScript 撰寫，例如 ECMA 262。 Windows Installer 不支援 JScript 1.0。 如需詳細資訊，請參閱 腳本。

來源

腳本會在目前的會話期間與應用程式一起安裝。 CustomAction 資料表的 [來源] 欄位包含File 資料表的索引鍵。 自訂動作程式碼的位置取決於此檔案的目標路徑解析;因此，此自訂動作必須在安裝檔案之後呼叫，並在移除檔案之前呼叫。

類型值

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

常數	十六進位	Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile	0x015	21

 

Windows Installer 可能會在 64 位作業系統上使用 64 位自訂動作 。 以腳本為基礎的 64 位自訂動作必須在其數數值型別中包含 msidbCustomActionType64BitScript 位。 如需詳細資訊，請參閱 64 位自訂動作。 在 CustomAction 資料表 的 Type 資料行中包含下列值，以指定 64 位自訂動作的基本數數值型別。

常數	十六進位	Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript	0x0001015	4117

 

目標

CustomAction 資料表的 [目標] 欄位包含選擇性腳本函式。 處理會先傳送腳本進行剖析，然後呼叫選擇性腳本函式。

傳回處理選項

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

執行排程選項

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

In-Script執行選項

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

傳回值

腳本中撰寫的選擇性函式必須傳回 JScript 和 VBScript 自訂動作傳回值中所述的其中一個值。

備註

以 JScript 或 VBScript 撰寫的自訂動作需要安裝 Session 物件。 安裝程式會將 Session 物件 附加至名稱為 「Session」 的腳本。 Because the Session object may not exist during an installation rollback, a deferred custom action written in script must use one of the methods or properties of the Session object described in the section Obtaining Context Information for Deferred Execution Custom Actions to retrieve its context.

參考已安裝檔案作為其來源的自訂動作，例如自訂動作類型 21 (JScript) ，必須遵守下列排序限制：

• 自訂動作必須在 CostFinalize 動作之後排序。 如此一來，自訂動作就可以解析找到包含 JScript 的來源檔案所需的路徑。
• 如果電腦上尚未安裝來源檔案，則延後 (腳本內) 此類型的自訂 動作必須在 InstallFiles 動作之後排序。
• 如果電腦上尚未安裝來源檔案，則必須在 InstallFinalize 動作之後排序此類型的非延後自訂動作。

相關主題

Custom_Actions