Tipo di azione personalizzato 21

  • Articolo

Questa azione personalizzata viene scritta in JScript, ad esempio ECMA 262. Windows Installer non supporta JScript 1.0. Per altre informazioni, vedere Script.

Source (Sorgente)

Lo script viene installato con l'applicazione durante la sessione corrente. Il campo Origine della tabella CustomAction contiene una chiave per la tabella File. Il percorso del codice azione personalizzato è determinato dalla risoluzione del percorso di destinazione per questo file; pertanto, questa azione personalizzata deve essere chiamata dopo l'installazione del file e prima che venga rimossa.

Valore del tipo

Includere il valore seguente nella colonna Tipo della tabella CustomAction per specificare il tipo numerico di base di un'azione personalizzata a 32 bit.

Costanti Valore esadecimale Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Windows Installer può usare azioni personalizzate a 64 bit nei sistemi operativi a 64 bit. Un'azione personalizzata a 64 bit basata sugli script deve includere il bit msidbCustomActionType64BitScript nel tipo numerico. Per informazioni, vedere Azioni personalizzate a 64 bit. Includere il valore seguente nella colonna Tipo della tabella CustomAction per specificare il tipo numerico di base di un'azione personalizzata a 64 bit.

Costanti Valore esadecimale Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

Destinazione

Il campo Target della tabella CustomAction contiene una funzione script facoltativa. L'elaborazione invia prima lo script per l'analisi e quindi chiama la funzione script facoltativa.

Opzioni di elaborazione restituite

Includere i bit di flag facoltativi nella colonna Tipo della tabella CustomAction per specificare le opzioni di elaborazione restituite. Per una descrizione delle opzioni e dei valori, vedere Custom Action Return Processing Options.For a description of the options and the values, see Custom Action Return Processing Options.

Opzioni di pianificazione dell'esecuzione

Includere i bit di flag facoltativi nella colonna Tipo della tabella CustomAction per specificare le opzioni di pianificazione dell'esecuzione. Queste opzioni controllano l'esecuzione multipla di azioni personalizzate. Per una descrizione delle opzioni, vedere Opzioni di pianificazione dell'esecuzione di azioni personalizzate.

opzioni di esecuzione In-Script

Includere i bit di flag facoltativi nella colonna Tipo della tabella CustomAction per specificare un'opzione di esecuzione in-script. Queste opzioni copiano il codice azione nello script di esecuzione, rollback o commit. Per una descrizione delle opzioni, vedere Custom Action In-Script Execution Options.

Valori restituiti

Le funzioni facoltative scritte nello script devono restituire uno dei valori descritti in Valori restituiti di JScript e azioni personalizzate VBScript.

Commenti

Un'azione personalizzata scritta in JScript o VBScript richiede l'oggetto Session di installazione. Il programma di installazione associa l'oggetto Sessione allo script con il nome "Session". Poiché l'oggetto Session potrebbe non esistere durante un rollback dell'installazione, un'azione personalizzata posticipata scritta nello script deve utilizzare uno dei metodi o delle proprietà dell'oggetto Session descritto nella sezione Ottenere informazioni di contesto per azioni personalizzate di esecuzione posticipata per recuperarne il contesto.

Le azioni personalizzate che fanno riferimento a un file installato come origine, ad esempio il tipo di azione personalizzato 21 (JScript), devono rispettare le restrizioni di sequenziazione seguenti:

  • L'azione personalizzata deve essere sequenziata dopo l'azione CostFinalize. In questo modo l'azione personalizzata può risolvere il percorso necessario per individuare il file di origine contenente JScript.
  • Se il file di origine non è già installato nel computer, le azioni personalizzate posticipate (in-script) di questo tipo devono essere sequenziate dopo l'azione InstallFiles.
  • Se il file di origine non è già installato nel computer, le azioni personalizzate non posticipate di questo tipo devono essere sequenziate dopo l'azione InstallFinalize.

Custom_Actions