Type d’action personnalisée 34
Cette action personnalisée appelle un exécutable lancé avec une ligne de commande. Pour plus d’informations, consultez Fichiers exécutables.
Source
L’exécutable est généré à partir d’un fichier. Le champ Source de la table CustomAction contient une clé de la table Directory. L’entrée de table Directory référencée est utilisée pour résoudre le chemin d’accès complet à un répertoire de travail. Ce n’est pas obligatoire pour définir comme le chemin d’accès au répertoire contenant l’exécutable.
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 + msidbCustomActionTypeDirectory | 0x022 | 34 |
Cible
La colonne Target de la table CustomAction contient le chemin d’accès complet et le nom du fichier exécutable, suivis des arguments facultatifs de l’exécutable. Le chemin d’accès complet et le nom du fichier exécutable sont requis. Les guillemets doivent être utilisés autour des noms de fichiers ou chemins d’accès longs. La valeur est traitée comme du texte mis en forme et peut contenir des références à des propriétés, des fichiers, des répertoires ou d’autres attributs de texte mis en forme.
Options de traitement du retour
Ajoutez des bits d’indicateurs 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 de l’action personnalisée.
Options de planification de l’exécution
Ajoutez des bits d’indicateurs 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 un script
Ajoutez des bits d’indicateurs facultatifs dans la colonne Type de la table CustomAction pour spécifier une option d’exécution dans un script. Ces options copient le code de l’action dans le script d’exécution, de restauration ou de validation. 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.
Rubriques connexes