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 de fichiers. L’emplacement du code d’action personnalisé est déterminé par la résolution du chemin d’accès cible de ce fichier ; par conséquent, cette action personnalisée doit être appelée une fois que le fichier a été installé et avant d’être supprimé.

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 Valeur hexadécimale Decimal
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile 0x016 22

Windows Le programme d’installation 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 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 64 bits.

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

Cible

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

Options de traitement des retours

Incluez les bits d’indicateur facultatifs dans la colonne type de la table CustomAction pour spécifier les options de traitement des retours. Pour obtenir une description des options et des valeurs, consultez options de traitement des retours d’actions personnalisées.

Options de planification de l’exécution

Incluez les 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 l’exécution multiple des actions personnalisées. Pour obtenir une description des options, consultez options de planification de l’exécution des actions personnalisées.

In-Script les options d’exécution

Incluez des bits d’indicateur facultatifs dans la colonne type de la table CustomAction pour spécifier une option d’exécution in-script. Ces options copient le code d’action dans le script d’exécution, de restauration ou 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.

Notes

une action personnalisée écrite en JScript ou VBScript requiert l' objet de Sessiond’installation. Il s’agit de l' objet de session de type 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 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 de contexte pour les actions personnalisées d’exécution différée afin d’extraire son contexte.

Les actions personnalisées qui font référence à un fichier installé comme source, telles que l’action personnalisée type 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.

Actions personnalisées _