Type d’action personnalisée 2
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 flux binaire temporaire. Le champ Source de la table CustomAction contient une clé de la table Binaire. La colonne Data de la table Binary contient les données de flux. Un flux distinct est alloué pour chaque ligne.
Vous pouvez insérer de nouvelles données binaires à partir d’un fichier en utilisant MsiRecordSetStream suivi de MsiViewModify pour insérer l’enregistrement dans la table. Quand l’action personnalisée est appelée, les données de flux sont copiées dans un fichier temporaire, qui est ensuite traité en fonction du type d’action personnalisée.
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 + msidbCustomActionTypeBinaryData | 0x002 | 2 |
Cible
La colonne Cible de la table CustomAction contient la chaîne de ligne de commande pour l’exécutable nommé dans la colonne Source.
Options de traitement du retour
Ajoutez des paramètres 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 de l’action personnalisée.
Options de planification de l’exécution
Ajoutez des paramètres 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 un script
Ajoutez des bits d’indicateur 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.
Quand une table de base de données est exportée, chaque flux est écrit dans un fichier distinct dans le sous-dossier nommé d’après la table, en utilisant la clé primaire comme nom de fichier (colonne Nom pour la table Binaire), avec l’extension par défaut « .ibd ». Le nom doit utiliser le format 8.3 si le système de fichiers ou le système de gestion de versions ne prend pas en charge les noms de fichier longs. Le fichier d’archive persistant remplace les données de flux par le nom de fichier utilisé, afin que les données puissent être localisées pendant l’importation de la table.
Rubriques connexes