Tabela TargetImages (Patchwiz.dll)

A tabela TargetImages contém informações sobre as imagens de destino do produto. Um pacote de patch do Windows Installer atualiza uma imagem de destino em uma imagem atualizada.

Uma tabela TargetImages que contenha, pelo menos, um registro é necessária em cada banco de dados de criação de patch (arquivo .pcp). Essa tabela é usada pela função UiCreatePatchPackage.

A tabela TargetImages tem as colunas a seguir.

Coluna Tipo Chave Nullable
Destino text S N
MsiPath text   N
SymbolPaths text   S
Atualizado text   N
Order inteiro   N
ProductValidateFlags text   S
IgnoreMissingSrcFiles inteiro   N

 

Colunas

Target

Identificador de uma imagem de destino. O pacote de patch atualiza a imagem de destino especificada nessa coluna para a imagem atualizada especificada na coluna Upgraded. Há uma ou mais imagens de destino para cada imagem atualizada. A imagem de destino precisa ser uma imagem de configuração totalmente descompactada do produto, como uma imagem administrativa ou uma imagem de configuração descompactada em um CD-ROM. Observe que a função UiCreatePatchPackageEx não gera patches binários para arquivos em gabinetes. O valor nesse campo é usado com o valor no campo Upgraded para gerar os nomes das transformações que o instalador adiciona ao pacote de patch.

MsiPath

Esse campo especifica o caminho completo, incluindo o nome do arquivo, para o local do arquivo .msi referente à imagem de destino. Esse é o local dos arquivos de origem referentes à imagem de destino.

SymbolPaths

Uma lista delimitada por ponto e vírgula de pastas que devem ser pesquisadas em busca de arquivos de símbolo que podem ser usados para otimizar a geração do patch binário. Observe que os subdiretórios de pastas especificados nesse campo não são pesquisados. Um patch binário otimizado pode ser menor. O Microsoft Visual C++ precisa ser instalado no computador que gera o patch e usado para criar os arquivos de símbolo. Esse campo é opcional, e o instalador criará um patch binário mesmo se nenhum arquivo de símbolo for especificado ou se os arquivos de símbolo ficarem indisponíveis para o Patchwiz.dll.

Upgraded

Chave estrangeira para a coluna Upgraded da tabela UpgradedImages. A função UiCreatePatchPackageEx ignora qualquer imagem atualizada que não seja referenciada por, pelo menos, um registro da tabela TargetImages.

Order

Ordem relativa da imagem de destino. Como vários destinos podem ser corrigidos para uma imagem atualizada, o campo Order fornece um meio de sequenciar as transformações na lista de transformações de patch. Normalmente, a ordem é da imagem mais antiga para a mais recente.

ProductValidateFlags

O campo ProductValidateFlags é usado para especificar a verificação de produtos para evitar a aplicação de transformações irrelevantes. O valor inserido nesse campo precisa ser um inteiro hexadecimal de oito dígitos e um dos valores válidos para o parâmetro iValidation da função MsiCreateTransformSummaryInfo. O valor padrão é 0x00000922, que é igual a MSITRANSFORM_VALIDATE_UPDATEVERSION + MSITRANSFORM_VALIDATE_NEWEQUALBASEVERSION + MSITRANSFORM_VALIDATE_UPGRADECODE + MSITRANSFORM_VALIDATE_PRODUCT.

IgnoreMissingSrcFiles

Se esse campo for definido como um valor diferente de zero, os arquivos ausentes da imagem de destino serão ignorados pelo instalador e deixados inalterados durante a aplicação de patch. Isso permite que os patches sejam feitos sem exigir a imagem inteira. Somente os arquivos alterados do produto e do arquivo .msi são necessários. Isso pode reduzir o tempo necessário para gerar o patch.

Observação

Não use o valor IgnoreMissingSrcFiles com TrustMsi definido como 1 na tabela Properties.

 

Comentários

Essa tabela aceita variáveis de ambiente como caminhos que começam com a versão 4.0 do Patchwiz.dll.