Type d’action personnalisé 18
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é 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.
| Constantes | Hexadécimal | Décimal |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeSourceFile | 0x012 | 18 |
Cible
La colonne Cible de la table CustomAction contient la chaîne de ligne de commande pour l’exécutable identifié dans la colonne Source.
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 actions personnalisées qui sont fichiers exécutables doivent retourner une valeur de 0 pour réussir. Le programme d’installation interprète toute autre valeur de retour comme un échec. Pour ignorer les valeurs de retour, définissez l’indicateur de bits msidbCustomActionTypeContinue dans le champ Type de la table CustomAction.
Remarques
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 lorsque 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 l’EXE.
- 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.
Rubriques connexes