Share via

Type d’action personnalisée 21

  • Article

Cette action personnalisée est écrite en JScript, par exemple ECMA 262. Windows Installer ne prend pas en charge JScript 1.0. Pour plus d’informations, consultez Scripts.

Source

Le script est installé avec l’application pendant la session active. Le champ Source de la table CustomAction contient une clé de la table File. L’emplacement du code d’action personnalisé est déterminé par la résolution du chemin d’accès cible pour ce fichier. Par conséquent, cette action personnalisée doit être appelée après l’installation du fichier et avant sa suppression.

Valeur du type

Ajoutez la valeur suivante dans la colonne Type de la table CustomAction pour spécifier le type numérique de base d’une action personnalisée 32 bits.

Constantes Valeur hexadécimale Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Windows Installer peut utiliser des actions personnalisées 64 bits sur les systèmes d’exploitation 64 bits. Une action personnalisée de 64 bits basée sur des scripts doit inclure le bit msidbCustomActionType64BitScript dans son type numérique. Pour plus d’informations, consultez Actions personnalisées 64 bits. Incluez la valeur suivante dans la colonne Type de la table CustomAction pour spécifier le type numérique de base d’une action personnalisée de 64 bits.

Constantes Valeur hexadécimale Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

Cible

Le champ Target de la table CustomAction contient une fonction de script facultative. Le traitement envoie d’abord le script pour analyse, puis appelle la fonction de script facultative.

Options de traitement du retour

Ajoutez des bits d’indicateur facultatifs dans la colonne Type de la table CustomAction pour spécifier les options de traitement du retour. Pour obtenir une description des options et des valeurs, consultez Options de traitement du retour des actions personnalisées.

Options de planification de l’exécution

Ajoutez des bits d’indicateur facultatifs dans la colonne Type de la table CustomAction pour spécifier les options de planification de l’exécution. Ces options contrôlent les différentes exécutions des actions personnalisées. Pour obtenir une description des options, consultez Options de planification de l’exécution des actions personnalisées.

Options d’exécution dans le script

Ajoutez des bits d’indicateur facultatifs dans la colonne Type de la table CustomAction pour spécifier une option d’exécution dans le script. Ces options copient le code d’action dans le script d’exécution, de restauration ou de commit. Pour obtenir une description des options, consultez Options d’exécution dans le script des actions personnalisées.

Valeurs de retour

Les fonctions facultatives écrites dans un script doivent retourner l’une des valeurs décrites au sein de Valeurs de retour des actions personnalisées JScript et VBScript.

Notes

Une action personnalisée écrite en JScript ou VBScript nécessite l’installation de l’objet Session. Le programme d’installation attache l’objet Session au script avec le nom « Session ». Étant donné que l’objet Session n’existe peut-être pas lors d’une restauration de l’installation, une action personnalisée différée écrite en script doit utiliser l’une des méthodes ou propriétés de l’objet Session décrit dans la section Obtention d’informations de contexte pour les actions personnalisées d’exécution différée pour récupérer son contexte.

Les actions personnalisées qui référencent un fichier installé comme source, comme le type d’action personnalisée 21 (JScript), doivent respecter les restrictions de séquencement suivantes :

  • L’action personnalisée doit être séquencée après l’action CostFinalize. Cela permet à l’action personnalisée de résoudre le chemin d’accès nécessaire pour localiser le fichier source contenant le code JScript.
  • Si le fichier source n’est pas déjà installé sur l’ordinateur, les actions personnalisées différées (dans le script) de ce type doivent être séquencées après l’action InstallFiles.
  • Si le fichier source n’est pas déjà installé sur l’ordinateur, les actions personnalisées non différées de ce type doivent être séquencées après l’action InstallFinalize.

Custom_Actions