Tabela ImageFamilies (Patchwiz.dll)

Uma família de imagens é um grupo de uma ou mais imagens atualizadas de um produto que foram atualizadas para a versão mais recente. Cada imagem atualizada pode pertencer a apenas uma família. As imagens atualizadas pertencentes a uma família de imagens partilham um ou mais ficheiros. Cada família de imagens tem seu próprio arquivo de gabinete no arquivo .msp contendo os patches binários e novos arquivos necessários para atualizar as diferenças entre os arquivos de destino e atualizados. O arquivo cabinet não replica os patches binários e novos arquivos usados pelos arquivos compartilhados.

Uma tabela ImageFamilies contendo pelo menos um registro é necessária em cada banco de dados de criação de patch (arquivo .pcp). Esta tabela é usada pela função UiCreatePatchPackageEx.

A tabela ImageFamilies contém as informações de aplicação de patches que devem ser adicionadas à tabela Media. Um patch adiciona uma entrada à tabela Media. Cada registro nas tabelas ImageFamilies refere-se a um grupo de imagens de produtos relacionadas que foram atualizadas para a versão mais recente do produto.

A tabela ImageFamilies tem as seguintes colunas. Um valor nulo pode ser usado nas colunas MediaSrcPropName, MediaDiskId e FileSequenceStart se o patch for aplicado com o Windows Installer e o Patchwiz.dll versão 2.0.

Coluna	Tipo	Chave	Nulo
Família	Texto	Y	N
MediaSrcPropName	Texto		Y
MediaDiskId	inteiro		Y
FileSequenceStart	inteiro		Y
DiskPrompt	Texto		Y
VolumeLabel	Texto		Y

 

Colunas

Família

O valor inserido neste campo é um identificador para um grupo de imagens de produto relacionadas que foram atualizadas para a versão mais recente do produto. Limitado a um total de 8 caracteres alfanuméricos ou sublinhados. O instalador incorpora um fluxo de gabinete no arquivo de patch do Windows Installer (arquivo .msp) para cada família na tabela. O gabinete contém os patches binários e novos arquivos necessários para atualizar uma imagem de destino em uma imagem atualizada do produto. O instalador prefixa o nome da família com PCW_CAB_ para gerar o nome do fluxo do gabinete que ele insere no campo Gabinete da nova tabela entrada.

MediaSrcPropName

O valor inserido no campo Source da nova tabela Media entrada da imagem atualizada. Este campo pode ser nulo somente se você estiver usando a versão 2.0 do Patchwiz.dll e se o MinimumRequiredMsiVersion na tabela Properties (Patchwiz.dll) estiver definido como 200.

MediaDiskId

O instalador insere esse valor no campo DiskId do novo registro tabela Media. O valor DiskID deve ser maior do que qualquer DiskID atual no pacote de destino. O limite para MediaDiskId é 32767. Este campo pode ser nulo somente se você estiver usando a versão 2.0 do Patchwiz.dll e se o MinimumRequiredMsiVersion na tabela Properties (Patchwiz.dll) estiver definido como 200.

FileSequenceStart

Este campo é o número de sequência do ficheiro inicial. Esse mesmo número de sequência de arquivo não deve existir em dois patches para o mesmo produto. Para garantir isso, o valor neste campo deve ser maior do que todos os números de sequência usados em patches anteriores ou no pacote de instalação original. O maior número de sequência em um patch pode ser determinado adicionando o número total de entradas no arquivo de gabinete do patch ao número FileSequenceStart desse patch. Uma maneira de determinar isso é examinar o arquivo .ddf gerado por Patchwiz.dll durante a criação do patch. O limite para FileSequenceStart é 32767. Este campo pode ser nulo somente se você estiver usando a versão 2.0 do Patchwiz.dll e se o MinimumRequiredMsiVersion na tabela Properties (Patchwiz.dll) estiver definido como 200.

DiskPrompt

O instalador insere esse valor no campo DiskPrompt do novo registro tabela Media.

VolumeLabel

O instalador insere esse valor no campo VolumeLabel do novo registro de mídia.

Comentários

O patch adiciona o nome do gabinete no arquivo .msp ao campo Gabinete do novo registro adicionado à tabela Media. Por ser um gabinete incorporado, o nome é prefixado com um caractere '#'. O patch adiciona uma propriedade ao campo Source do novo registro na tabela Media. Não há dois patches que possam ter a mesma propriedade de origem.

Os arquivos compartilhados dentro da família de imagens devem ter a mesma chave de tabela de arquivos em cada imagem atualizada da família. Todas as chaves de tabela de arquivos compartilhadas entre as imagens atualizadas devem representar o mesmo arquivo e devem ser idênticas em todas as imagens atualizadas. A chave da tabela de arquivos é o valor inserido na coluna Arquivo da tabela Arquivo .

O limite para MediaDiskId e FileSequenceStart é 32767. Para aumentar esse limite, exporte a tabela ImageFamilies para um arquivo .idt com Msidb.exe e altere o tipo de coluna de i2 para i4 ou de I2 para I4 e, em seguida, importe o arquivo .idt de volta para o banco de dados .pcp. Transformações e patches não podem ser criados entre dois pacotes com tipos de coluna diferentes.