Tabla de archivos

La tabla de archivos contiene una lista completa de archivos de origen con sus distintos atributos, ordenados por un identificador único, no localizado. Los archivos se pueden almacenar en el medio de origen como archivos individuales o comprimidos dentro de un archivo contenedor. Para obtener más información, vea Using Cabinets and Compressed Sources.

La tabla de archivos tiene las columnas siguientes.

Columna	Tipo	Llave	Nullable
Archivo	identificador	Y	N
Componente_	identificador	N	N
Nombre	nombre de archivo	N	N
FileSize	DoubleInteger	N	N
Versión	versión de	N	Y
Idioma	Language	N	Y
Atributos	entero	N	Y
Secuencia	entero	N	N

 

Columnas

archivo de

Token no localizado que identifica de forma única el archivo. Este campo no distingue mayúsculas de minúsculas. No asigne identificadores a archivos diferentes que solo difieren en su caso.

Component_

Clave externa en la primera columna de la tabla de componentes de . Este campo identifica el componente que controla el archivo.

FileName

Nombre de archivo usado para la instalación. El nombre se puede localizar.

Dado que algunos servidores web pueden distinguir mayúsculas de minúsculas, FileName debe coincidir exactamente con el caso de los archivos de origen para garantizar la compatibilidad con las descargas de Internet.

fileSize de

Tamaño del archivo en bytes. Debe ser un número no negativo.

versión de

Este campo es la cadena de versión de un archivo con versiones. Este campo está en blanco para los archivos sin versiones. La versión del archivo especificada en este campo debe ser idéntica a la versión del archivo incluido con el paquete de instalación.

El campo Versión también se puede establecer para que contenga la clave principal de otro registro en la tabla Archivo. A continuación, el archivo al que se hace referencia determina la lógica de control de versiones de este archivo. Para obtener más información, vea archivos complementarios. Tenga en cuenta que si este archivo es la ruta de acceso de clave de su componente, no debe especificarse como un archivo complementario.

idioma de

Lista de identificadores de idioma decimal separados por comas.

Los archivos de fuente no deben crearse con un identificador de idioma, ya que las fuentes no tienen un recurso de identificador de idioma incrustado. Por lo tanto, esta columna debe dejarse null para los archivos de fuente.

atributos de

Entero que contiene marcas de bits que representan atributos de archivo.

En la tabla siguiente se muestra la definición del campo de bits.

Constante	Hexadecimal	Decimal	Descripción
msidbFileAttributesReadOnly	0x000001	1	Read-Only
msidbFileAttributesHidden	0x000002	2	Escondido
msidbFileAttributesSystem	0x000004	4	Sistema
msidbFileAttributesVital	0x000200	512	El archivo es fundamental para el funcionamiento preciso del componente al que pertenece. Si se produce un error en la instalación de un archivo con el atributo msidbFileAttributesVital, la instalación se detiene y se revierte. En este caso, el instalador muestra un cuadro de diálogo sin un botón Omitir. Si no se establece este atributo y se produce un error en la instalación del archivo, el instalador muestra un cuadro de diálogo con un botón Omitir. En este caso, el usuario puede optar por omitir el error de instalación del archivo y continuar.
msidbFileAttributesChecksum	0x000400	1024	El archivo contiene una suma de comprobación válida. Se requiere una suma de comprobación para reparar un archivo que se ha dañado.
msidbFileAttributesPatchAdded	0x001000	4096	Este bit solo debe agregarse mediante una revisión y si el archivo se agrega mediante la revisión.
msidbFileAttributesNoncompressed	0x002000	8192	El tipo de origen del archivo no está comprimido. Si se establece, omita la propiedadresumen de recuento de palabras. Si ni msidbFileAttributesNoncompressed ni msidbFileAttributesCompressed se establecen, el estado de compresión del archivo se especifica mediante la propiedad Word Count Summary. No establezca tanto msidbFileAttributesNoncompressed y msidbFileAttributesCompressed.
msidbFileAttributesCompressed	0x004000	16384	El tipo de origen del archivo está comprimido. Si se establece, omita la propiedadresumen de recuento de palabras. Si ni msidbFileAttributesNoncompressed ni msidbFileAttributesCompressed se establecen, el estado de compresión del archivo se especifica mediante la propiedad Word Count Summary. No establezca tanto msidbFileAttributesNoncompressed y msidbFileAttributesCompressed.

 

Si se establece el msidbFileAttributesVital bit dentro de la columna Atributos y, si el componente al que pertenece el archivo está seleccionado para la instalación, el instalador debe poder instalar este archivo para que la instalación se complete correctamente. Si el instalador no puede instalar el archivo por algún motivo (por ejemplo, si el archivo de origen no se encuentra dentro de la imagen de origen), aparecerá un cuadro de diálogo de error con las opciones "Reintentar" o "Cancelar". Para un archivo que no tenga msidbFileAttributesVital establecido, las opciones en caso de error de instalación serán "Abort", "Retry" y "Ignore" (es decir, el usuario tendrá la opción de completar la instalación correctamente sin instalar ese archivo).

El msidbFileAttributesChecksum bit dentro de la columna Atributos debe establecerse para cada archivo ejecutable de la instalación que tenga una suma de comprobación válida almacenada en el encabezado de archivo ejecutable portable (PE). Solo se comprobarán los archivos que tienen este conjunto de bits para comprobar si hay una suma de comprobación válida durante una reinstalación. Para obtener más información, consulte elREINSTALLMODE .

secuencia de

Posición de secuencia de este archivo en las imágenes multimedia. Este orden debe corresponder al orden de los archivos del gabinete si los archivos se comprimen. Los enteros de este campo deben ser iguales o mayores que 1.

Los números de secuencia de la columna Secuencia se usan para especificar tanto el orden de instalación de los archivos como el medio de origen en el que se encuentra el archivo (junto con la tabla multimedia de ). Por ejemplo, supongamos que un archivo tiene un número de secuencia de 92. Para determinar el disco de origen en el que reside este archivo, busque en la tabla Multimedia la entrada con el valor de Última secuencia más pequeño que sea mayor que 92.

Aunque a los archivos comprimidos se les asignan números de secuencia internos dentro de los gabinetes, esos números absolutos no necesitan coincidir con los números de secuencia dentro de la tabla Archivo. Sin embargo, es importante que la secuencia de archivos de la tabla Archivo sea idéntica a la secuencia de los archivos dentro de los gabinetes.

En el caso de los archivos que no están comprimidos, los números de secuencia no deben ser únicos. Por ejemplo, si todos los archivos no están comprimidos y todos residen en un disco, podría proporcionar a todos los archivos el mismo número de secuencia.

El límite máximo es de 32767 archivos. Para crear un paquete de Windows Installer con más archivos, consulte Creación de un paquete grande.

Observaciones

Las acciones de InstallFiles y RemoveFiles en las tablas de secuencia de procesar la información de esta tabla. Para obtener información sobre el uso de tablas de secuencia de , vea Using a Sequence Table.

La tabla se genera inicialmente a partir de la lista de archivos, pero si se usa la compresión del gabinete, la tabla se regenera a partir de la salida del motor de compresión. Para obtener más información, vea archivos de gabinete.

Para mover un archivo existente en el equipo del usuario durante la instalación, use el de acción MoveFiles de y tabla MoveFile. Para instalar un archivo en varias ubicaciones, use el de acción DuplicateFiles de y la tabla DuplicateFile .

En la tabla siguiente se resumen las posibles combinaciones de valores de la columna Versión y la columna Idioma. Para obtener más información, vea reglas de control de versiones de archivos.

Versión	Idioma	Descripción
1.2.3.4	1033	La versión y el idioma.
1.2.3.4	(Null)	Versión pero sin idioma.
1.2.3.4	0	La versión y el idioma son neutros.
Testdb	(Null)	El archivo complementario sin idioma asociado.
Testdb	1033	El archivo y el idioma complementarios.
(Null)	1033	No hay ninguna versión, pero tiene un lenguaje asociado (es decir, typelib, helpfile).

 

Para obtener más información, vea tabla MsiLockPermissionsEx y tabla LockPermissions.

Validación

ice02
ICE03
ICE04
ICE06
ICE18
ICE30
ICE32
ICE35
ICE39
ICE42
ICE45
ICE50
ice51
ICE54
ICE55
ICE57
ICE59
ICE60
ICE67
ICE69
ICE76
ICE91