Tabela de arquivos

A Tabela de Arquivos contém uma lista completa de arquivos de origem com seus vários atributos, ordenados por um identificador exclusivo e não localizado. Os arquivos podem ser armazenados na mídia de origem como arquivos individuais ou compactados dentro de um arquivo de gabinete . Para obter mais informações, consulte Usando gabinetes e fontes compactadas.

A tabela de arquivos tem as seguintes colunas.

Colunas

Ficheiro

Um token não localizado que identifica exclusivamente o arquivo. Este campo é insensível a maiúsculas e minúsculas. Não atribua identificadores a arquivos diferentes que diferem apenas por maiúsculas e minúsculas.

Component_

A chave externa na primeira coluna da Tabela de componentes . Este campo identifica o componente que controla o arquivo.

Nome do arquivo

O nome do arquivo usado para a instalação. O nome pode estar localizado.

Como alguns servidores Web podem diferenciar maiúsculas de minúsculas, FileName deve corresponder exatamente ao caso dos arquivos de origem para garantir o suporte a downloads da Internet.

FileSize

O tamanho do arquivo em bytes. Este deve ser um número não negativo.

Versão

Este campo é a cadeia de caracteres de versão para um arquivo versionado. Este campo está em branco para arquivos sem versão. A versão do ficheiro introduzida neste campo tem de ser idêntica à versão do ficheiro incluída no pacote de instalação.

O campo Versão também pode ser definido para conter a chave primária de outro registro na tabela Arquivo. Em seguida, o arquivo referenciado determina a lógica de controle de versão para esse arquivo. Para obter mais informações, consulte Companion Files. Observe que, se esse arquivo for o caminho de chave para seu componente, ele não deve ser especificado como um arquivo complementar.

Língua

Uma lista de IDs de idioma decimal separados por vírgulas.

Os arquivos de fonte não devem ser criados com uma ID de idioma, pois as fontes não têm um recurso de ID de idioma incorporado. Assim, esta coluna deve ser deixada nula para arquivos de fonte.

Atributos

O inteiro que contém sinalizadores de bit que representam atributos de arquivo.

A tabela a seguir mostra a definição do campo de bits.

Constante	Hexadecimal	Decimal	Descrição
msidbFileAttributesReadOnly	0x000001	1	Read-Only
msidbFileAttributesHidden	0x000002	2	Escondido
msidbFileAttributesSystem	0x000004	4	Sistema
msidbFileAttributesVital	0x000200	512	O arquivo é vital para o funcionamento preciso do componente ao qual pertence. Se a instalação de um arquivo com o atributo msidbFileAttributesVital falhar, a instalação será interrompida e revertida. Nesse caso, o instalador exibe uma caixa de diálogo sem um botão Ignorar. Se esse atributo não estiver definido e a instalação do arquivo falhar, o instalador exibirá uma caixa de diálogo com um botão Ignorar. Nesse caso, o usuário pode optar por ignorar a falha na instalação do arquivo e continuar.
msidbFileAttributesChecksum	0x000400	1024	O arquivo contém uma soma de verificação de válida. Uma soma de verificação é necessária para reparar um arquivo que foi corrompido.
msidbFileAttributesPatchAdded	0x001000	4096	Este bit só deve ser adicionado por um patch e se o arquivo estiver sendo adicionado pelo patch.
msidbFileAttributes não compactado	0x002000	8192	O tipo de origem do arquivo é descompactado. Se estiver definido, ignore a Resumo da Contagem de Palavras Propriedade. Se nem msidbFileAttributes não compactado ou msidbFileAttributesCompressed estiverem definidos, o estado de compactação do arquivo será especificado pela propriedade Word Count Summary Property. Não defina msidbFileAttributesNoncompressed e msidbFileAttributesCompressed.
msidbFileAttributesCompressed	0x004000	16384	O tipo de origem do arquivo é compactado. Se estiver definido, ignore a Resumo da Contagem de Palavras Propriedade. Se nem msidbFileAttributes não compactado ou msidbFileAttributesCompressed estiverem definidos, o estado de compactação do arquivo será especificado pela propriedade Word Count Summary Property. Não defina msidbFileAttributesNoncompressed e msidbFileAttributesCompressed.

 

Se o msidbFileAttributesVital bit dentro da coluna Atributos estiver definido e se o componente ao qual o arquivo pertence estiver selecionado para instalação, o instalador deverá ser capaz de instalar esse arquivo para que a instalação seja concluída com êxito. Se o instalador não conseguir instalar o arquivo por algum motivo (por exemplo, se o arquivo de origem não puder ser localizado na imagem de origem), uma caixa de diálogo de erro aparecerá com as opções "Repetir" ou "Cancelar". Para um arquivo que não tem msidbFileAttributesVital definido, as opções em caso de um erro de instalação serão "Abortar", "Repetir" e "Ignorar" (ou seja, o usuário terá a opção de concluir a instalação com êxito sem instalar esse arquivo).

O msidbFileAttributesChecksum bit dentro da coluna Atributos deve ser definido para cada arquivo executável na instalação que tenha umde soma de verificação deválido armazenado no cabeçalho do arquivo executável portátil (PE). Somente os arquivos que têm esse bit definido serão verificados quanto à soma de verificação válida durante uma reinstalação. Para obter mais informações, consulte o REINSTALLMODE.

Sequência

Posição de seqüência deste arquivo nas imagens de mídia. Esta ordem deve corresponder à ordem dos arquivos no gabinete se os arquivos forem compactados. Os números inteiros neste campo devem ser iguais ou superiores a 1.

Os números de sequência na coluna Sequência são usados para especificar a ordem de instalação dos arquivos e a mídia de origem na qual o arquivo está localizado (em conjunto com a Tabela de Mídia ). Por exemplo, suponha que um arquivo tenha um número de sequência de 92. Para determinar o disco de origem em que esse arquivo reside, procure na tabela Mídia a entrada com o menor valor de Última Sequência maior que 92.

Embora os arquivos compactados recebam números de sequência internos dentro de gabinetes, esses números absolutos não precisam corresponder aos números de sequência na tabela Arquivo. No entanto, é importante que a sequência de arquivos na tabela File seja idêntica à sequência dos arquivos dentro dos gabinetes.

Para arquivos que não são compactados, os números de sequência não precisam ser exclusivos. Por exemplo, se todos os seus arquivos forem descompactados e todos residirem em um disco, você poderá dar a todos os arquivos o mesmo número de sequência.

O limite máximo é de 32767 ficheiros. Para criar um pacote do Windows Installer com mais arquivos, consulte Criação de um pacote grande.

Comentários

O InstallFiles e RemoveFiles ações nas tabelas de sequência de processar as informações nesta tabela. Para obter informações sobre como usar tabelas de sequência, consulte Usando uma tabela de sequência.

A tabela é inicialmente gerada a partir da lista de arquivos, mas se a compactação de gabinete for usada, a tabela será regenerada a partir da saída do mecanismo de compactação. Para obter mais informações, consulte arquivos de gabinete.

Para mover um arquivo existente no computador do usuário durante a instalação, use o MoveFiles Action e Tabela MoveFile. Para instalar um arquivo em vários locais, use o de ação DuplicateFiles e a tabela DuplicateFile.

A tabela a seguir resume as combinações possíveis de valores na coluna Versão e na coluna Idioma. Para obter mais informações, consulte File Versioning Rules.

Para obter mais informações, consulte a Tabela MsiLockPermissionsEx e Tabela LockPermissions.

Validação

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