Partager via


Type d’action personnalisé 21

Cette action personnalisée est écrite en JScript, telle qu’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é pour la table Fichier. 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 une fois le fichier installé et avant sa suppression.

Valeur de type

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 32 bits.

Constantes Hexadécimal Décimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Windows Installer peut utiliser actions personnalisées 64 bits sur les systèmes d’exploitation 64 bits. Une action personnalisée 64 bits basée sur des scripts doit inclure la msidbCustomActionType64BitScript bit 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 64 bits.

Constantes Hexadécimal Décimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

Cible

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

Options de traitement de retour

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

Options de planification d’exécution

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

options d’exécution In-Script

Incluez 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 l’exécution, la restauration ou le script de validation. Pour obtenir une description des options, consultez Action personnalisée In-Script Options d’exécution.

Valeurs de retour

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

Remarques

Une action personnalisée écrite dans JScript ou VBScript nécessite l’installation '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 pendant une restauration d’installation, une action personnalisée différée écrite dans le script doit utiliser l’une des méthodes ou propriétés de l’objet Session décrit dans la section Obtention d’informations contextuelles pour les actions personnalisées différées d’exécution 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é 21 (JScript), doivent respecter les restrictions de séquencement suivantes :

  • L’action personnalisée doit être séquencée après l’action CostFinalize. Ainsi, l’action personnalisée peut résoudre le chemin d’accès nécessaire pour localiser le fichier source contenant le JScript.
  • Si le fichier source n’est pas déjà installé sur l’ordinateur, les actions personnalisées différées (en 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