Type d’action personnalisé 6
Cette action personnalisée est écrite en VBScript. 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é 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 d’une action personnalisée 32 bits.
| Constantes | Valeur hexadécimale | Decimal |
|---|---|---|
| msidbCustomActionTypeVBScript + msidbCustomActionTypeBinaryData | 0x006 | 6 |
Windows Le programme d’installation 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 inclure le bit msidbCustomActionType64BitScript dans son type numérique. Pour plus d’informations , consultez actions personnalisées 64 bits. Incluez 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 |
|---|---|---|
| msidbCustomActionTypeVBScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript | 0x0001006 | 4102 |
Cible
Le champ cible de la table CustomAction contient une fonction de script facultative. Le traitement envoie tout d’abord le script pour l’analyse, puis appelle la fonction de script facultative.
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 fonctions facultatives écrites dans le script doivent retourner l’une des valeurs décrites dans 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 de Session. Le programme d’installation joint l’objet de session au script avec la session de nom. Étant donné que l’objet session n’existe peut-être pas lors d’une restauration de l’installation, une action personnalisée différée écrite dans le script doit utiliser l’une des méthodes ou propriétés de l’objet session décrit dans la section obtention d’informations de contexte pour les actions personnalisées d’exécution différée afin d’extraire son contexte.
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 de nom de fichier 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.