Partager via

Type d’action personnalisé 18

  • Article

Cette action personnalisée appelle un exécutable lancé avec une ligne de commande.

Source

L’exécutable est généré à partir d’un fichier installé avec l’application. 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

Incluez la valeur suivante dans la colonne Type de la table CustomAction pour spécifier le type numérique de base.

Constantes Valeur hexadécimale Decimal
msidbCustomActionTypeExe + msidbCustomActionTypeSourceFile 0x012 18

 

Cible

La colonne Target de la table CustomAction contient la chaîne de ligne de commande pour l’exécutable identifié dans la colonne Source.

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 actions personnalisées qui sont des fichiers exécutables doivent retourner une valeur de 0 pour indiquer la réussite. Le programme d’installation traite toute autre valeur de retour comme un échec. Pour ignorer les valeurs de retour, définissez l’indicateur de bit msidbCustomActionTypeContinue dans le champ Type de la table CustomAction.

Notes

Une action personnalisée qui lance un exécutable prend une ligne de commande, qui contient généralement des propriétés désignées dynamiquement. S’il s’agit également d’une action personnalisée d’exécution différée, le programme d’installation utilise CreateProcessAsUser ou CreateProcess pour créer le processus quand l’action personnalisée est appelée à partir du script d’installation.

Les actions personnalisées qui référencent un fichier installé comme source, comme le type d’action personnalisée 18 (EXE), 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 EXE.
  • 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

Fichiers exécutables