Acción InstallFiles
La acción InstallFiles copia los archivos especificados en la tabla Archivo del directorio de origen al directorio de destino.
Restricciones de secuencia
La acción InstallFiles debe aparecer después de la acción InstallValidate y antes de cualquier acción dependiente del archivo.
Mensajes actionData
| Campo | Descripción de los datos de acción |
|---|---|
| [1] | Identificador del archivo instalado. |
| [6] | Tamaño del archivo instalado en bytes. |
| [9] | Identificador del directorio que contiene el archivo instalado. |
Observaciones
La acción InstallFiles funciona en los archivos especificados en la tabla archivo de . Cada archivo se instala en función del estado de instalación del componente asociado del archivo en la tabla componente de . Solo los archivos cuyos componentes se resuelven en el msiInstallStatelocal estado pueden copiarse.
La acción InstallFiles implementa las siguientes columnas de la tabla Archivo.
- La columna FileName especifica el nombre del archivo de destino.
- La columna Versión especifica la versión del archivo.
- La columna Atributos especifica los bits de la marca de atributo de instalación y archivo.
- La columna Archivo especifica el token de archivo único.
- La columna FileSize especifica el tamaño de archivo sin comprimir en bytes.
- La columna Idioma especifica el identificador de idioma de archivo.
- La columna Secuencia especifica el número de secuencia en los medios.
La acción InstallFiles implementa las siguientes columnas de la tabla Componente.
- La columna Directory_ especifica una referencia a una tabla de Directory elemento.
- La columna Componente especifica un nombre único para el elemento de componente.
El archivo especificado solo se copia si se cumple una de las siguientes condiciones:
- El archivo no está instalado actualmente en el equipo local.
- El archivo está en el equipo local, pero tiene un número de versión inferior al del archivo de la tabla archivo de .
- El archivo está en el equipo local, pero no hay ningún número de versión asociado.
El directorio de origen de cada archivo que se va a copiar viene determinado por sourceMode, que a su vez depende del valor de la columna Cabinet de la tabla Media. Para obtener una explicación completa del modo de origen, vea la tabla Media.
Si el directorio de origen de un archivo que se va a copiar reside en medios extraíbles, como un disco de disquete o CD-ROM, la acción InstallFiles comprueba que se inserta el medio de origen adecuado antes de intentar copiar el archivo. InstallFiles busca medios del mismo tipo extraíble con un volumen etiqueta que coincida con el valor proporcionado en la columna VolumeLabel de la tabla Media. Si se encuentra un volumen montado coincidente, el proceso de copia de archivos continúa. Si no se encuentra ninguna coincidencia, un cuadro de diálogo solicita al usuario que inserte los medios adecuados. En este caso, el cuadro de diálogo usa el nombre multimedia que se encuentra en la columna DiskPrompt de la tabla Media como parte del símbolo del sistema.
Se debe tener precaución porque la acción InstallFiles puede eliminar un archivo original y no reemplazarlo. Esto ocurre cuando la acción InstallFiles experimenta un error al reemplazar un archivo anterior y el usuario decide omitir el error. El comportamiento predeterminado del instalador es eliminar un archivo antiguo antes de asegurarse de que el nuevo archivo se copia correctamente.
Para conocer las reglas de control de versiones de archivos usadas por el instalador, consulte Reglas de control de versiones de archivos.