Type d’action personnalisée 5
Cette action personnalisée est écrite en JScript, par exemple ECMA 262. Windows Installer ne prend pas en charge JScript 1.0. Pour plus d’informations, consultez Scripts.
Source
Le script est généré à partir d’un flux binaire temporaire. Le champ Source de la table CustomAction contient une clé de la table Binary. La colonne Data de la table Binary 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 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
Ajoutez la valeur suivante dans la colonne Type de la table CustomAction pour spécifier le type numérique de base d’une action personnalisée 32 bits.
| Constantes | Valeur hexadécimale | Decimal |
|---|---|---|
| msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData | 0x05 | 5 |
Windows Installer peut utiliser des actions personnalisées 64 bits sur les systèmes d’exploitation 64 bits. Une action personnalisée 64 bits basée sur des scripts doit avoir le bit msidbCustomActionType64BitScript dans son type numérique. Pour plus d’informations, consultez Actions personnalisées 64 bits. Ajoutez la valeur suivante dans la colonne Type de la table CustomAction pour spécifier le type numérique de base d’une action personnalisée 64 bits.
| Constantes | Valeur hexadécimale | Decimal |
|---|---|---|
| msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript | 0x0001005 | 4101 |
Cible
Le champ Target de la table CustomAction contient une fonction de script facultative. Le traitement envoie d’abord le script pour analyse, puis appelle la fonction de script facultative.
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 fonctions facultatives écrites dans un script doivent retourner l’une des valeurs décrites au sein de Valeurs de retour des actions personnalisées JScript et VBScript.
Notes
Une action personnalisée écrite en JScript ou VBScript nécessite l’installation de l’Objet Session. Le programme d’installation attache l’objet Session au script avec le nom Session. Dans la mesure où l’objet Session n’existe peut-être pas durant une restauration de l’installation, une action personnalisée différée écrite dans un script doit utiliser l’une des méthodes ou propriétés de l’objet Session décrites dans la section Obtention d’informations de contexte pour les actions personnalisées à exécution différée afin de récupérer son contexte.
Quand une table de base de données est exportée, chaque flux est écrit sous forme de fichier distinct dans le sous-dossier nommé en fonction de la table, en utilisant la clé primaire comme nom de fichier (colonne Name de la table Binary), avec l’extension par défaut « .ibd ». Le nom doit être au format de nom de fichier 8.3 si le système de fichiers ou le système de gestion de versions 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é, ce qui permet de localiser les données au moment de l’importation de la table.
Rubriques connexes