Type d’action personnalisée 22
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.
Rubriques connexes