Partager via

InstallFiles Action

  • Article

L’action InstallFiles copie les fichiers spécifiés dans la table Fichier du répertoire source vers le répertoire de destination.

Restrictions de séquence

L’action InstallFiles doit se présenter après l’action InstallValidate et avant toutes les actions dépendantes du fichier.

ActionData Messages

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é.

 

Remarques

L’action InstallFiles fonctionne sur les fichiers spécifiés dans la table fichier . Chaque fichier est installé en fonction de l’état d’installation du composant associé du fichier dans la table composant . Seuls les fichiers dont les composants sont résolus vers l’état msiInstallStatelocal sont éligibles à la copie.

L’action InstallFiles implémente les colonnes suivantes de la table Fichier.

  • La colonne FileName spécifie le nom du fichier cible.
  • La colonne Version spécifie la version du fichier.
  • La colonne Attributs spécifie les bits d’indicateur d’attribut de fichier et d’installation.
  • La colonne Fichier spécifie le jeton de fichier unique.
  • La colonne FileSize spécifie la taille de fichier non compressée en octets.
  • La colonne Langue spécifie l’identificateur de langue du fichier.
  • La colonne Séquence spécifie le numéro de séquence sur le support.

L’action InstallFiles implémente les colonnes suivantes de la table Composant.

  • La colonne Directory_ spécifie une référence à une table Directory élément.
  • La colonne Composant spécifie un nom unique pour l’élément de composant.

Le fichier spécifié est copié uniquement si l’une des valeurs suivantes est true :

  • Le fichier n’est actuellement pas installé sur l’ordinateur local.
  • Le fichier se trouve sur l’ordinateur local, mais a un numéro de version inférieur au fichier dans la table Fichier.
  • Le fichier se trouve sur l’ordinateur local, mais il n’existe aucun numéro de version associé.

Le répertoire source de chaque fichier à copier est déterminé par le sourceMode, qui dépend à son tour de la valeur dans la colonne Cabinet de la table Media. Pour une discussion complète sur le mode source, consultez la table Media.

Si le répertoire source d’un fichier à copier réside sur un média amovible tel qu’un disque de floppy 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 le média du même type amovible avec un volume étiquette qui correspond à la valeur donnée dans la colonne VolumeLabel de la table Media. Si un volume monté correspondant est trouvé, le processus de copie de fichier 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 du média trouvé dans la colonne DiskPrompt de la table Media dans le cadre de l’invite.

Attention doit être exercée, car l’action InstallFiles peut supprimer un fichier d’origine et ne pas le remplacer. Cela se produit lorsque l’action InstallFiles rencontre une erreur lors du remplacement d’un fichier plus ancien 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 contrôle de version des fichiers utilisées par le programme d’installation, consultez règles de contrôle de version de fichier.