Type d’action personnalisé 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é pour la table binaire. La colonne de données de la table binaire contient les données de flux. Un flux distinct est alloué pour chaque ligne.

De nouvelles données binaires peuvent être insérées à partir d’un fichier à l’aide de MsiRecordSetStream , puis de MsiViewModify pour insérer l’enregistrement dans la table. Lorsque 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 de 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 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 actions personnalisées qui sont des fichiers exécutables doivent retourner la valeur 0 en cas de réussite. 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 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 qui sont 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.

Lorsqu’une table de base de données est exportée, chaque flux est écrit sous la forme d’un fichier distinct dans le sous-dossier nommé d’après la table, à l’aide de la clé primaire en tant que nom de fichier (colonne de 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 version ne prend pas en charge les noms de fichiers 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 lors de l’importation de la table.

Actions personnalisées _

Fichiers exécutables