Share via

Type d’action personnalisée 22

  • Article

Cette action personnalisée est écrite en VBScript. Voir aussi 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
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile 0x016 22

 

Windows Installer peut utiliser des 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 avoir le bit msidbCustomActionType64BitScript dans son type numérique. Pour plus d’informations, consultez Actions personnalisées 64 bits. 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 64 bits.

Constantes Valeur hexadécimale Decimal
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001016 4118

 

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’objet de session de l’installation. Il est de type Objet de session, et le programme d’installation l’attache 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 22 (VBcript), 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 VBScript.
  • 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