InstallFiles, action
L’action InstallFiles copie les fichiers spécifiés dans la table File du répertoire source vers le répertoire de destination.
Restrictions de séquence
L’action InstallFiles doit venir après l’action InstallValidate et avant les actions dépendantes d’un fichier.
Messages ActionData
| Champ | Description des données d’action |
|---|---|
| [1] | Identificateur du fichier installé. |
| [6] | Taille du fichier installé en octets. |
| [9] | Identificateur du répertoire contenant le fichier installé. |
Notes
L’action InstallFiles agit sur les fichiers spécifiés dans la table File. Chaque fichier est installé en fonction de l’état d’installation du composant associé au fichier dans la table Component. Seuls les fichiers dont les composants sont résolus à l’état msiInstallStatelocal sont éligibles pour la copie.
L’action InstallFiles implémente les colonnes suivantes de la table File.
- La colonne FileName spécifie le nom du fichier cible.
- La colonne Version spécifie la version du fichier.
- La colonne Attributes spécifie les bits d’indicateur d’attribut de fichier et d’installation.
- La colonne File spécifie le jeton de fichier unique.
- La colonne FileSize spécifie la taille de fichier décompressée en octets.
- La colonne Language spécifie l’identificateur de langue du fichier.
- La colonne Sequence spécifie le numéro de séquence sur le média.
L’action InstallFiles implémente les colonnes suivantes de la table Component.
- La colonne Directory_ spécifie une référence à un élément de la table Directory.
- La colonne Component spécifie un nom unique pour l’élément de composant.
Le fichier spécifié est copié uniquement si l’une des conditions suivantes est vraie :
- Le fichier n’est pas installé sur l’ordinateur local.
- Le fichier se trouve sur l’ordinateur local, mais il comporte un numéro de version inférieur à celui du fichier présent dans la table File.
- Le fichier se trouve sur l’ordinateur local mais aucun numéro de version n’est associé.
Le répertoire source de chaque fichier à copier est déterminé par sourceMode, qui dépend à son tour de la valeur de la colonne Cabinet de la table Media. Pour une présentation complète du mode de gestion de la source, consultez la table Media.
Si le répertoire source d’un fichier à copier se trouve sur un média amovible tel qu’une disquette ou un CD-ROM, l’action InstallFiles vérifie que le média source approprié est inséré avant de tenter de copier le fichier. InstallFiles recherche les médias amovibles de même type dont l’étiquette volume correspond à la valeur spécifiée dans la colonne VolumeLabel de la table Media. Si un volume monté correspondant est trouvé, le processus de copie des fichiers se poursuit. Si aucune correspondance n’est trouvée, une boîte de dialogue demande à l’utilisateur d’insérer le média approprié. Dans ce cas, la boîte de dialogue utilise le nom de média trouvé dans la colonne DiskPrompt de la table Media dans le cadre de l’invite.
Vous devez être prudent, car l’action InstallFiles peut supprimer un fichier d’origine mais pas le remplacer. Cela se produit quand l’action InstallFiles rencontre une erreur durant le remplacement d’un ancien fichier, et que l’utilisateur choisit d’ignorer l’erreur. Le comportement par défaut du programme d’installation consiste à supprimer un ancien fichier avant de vérifier que le nouveau fichier est copié correctement.
Pour connaître les règles de gestion de versions de fichiers utilisées par le programme d’installation, consultez Règles de gestion de versions des fichiers.