Partilhar via

Tabela de propriedades (Patchwiz.dll)

  • Artigo

A Tabela de propriedades contém configurações globais para o pacote de patch. A Tabela de Propriedades é necessária no banco de dados de criação de patches (arquivo .pcp) e é usada pela função UiCreatePatchPackageEx.

A Tabela de propriedades tem as seguintes colunas.

Coluna Tipo Chave Nulo
Designação Texto Y N
Valor Texto Y

 

Colunas

Nome

O nome de uma propriedade de criação de patch.

Valor

O valor da propriedade de criação do patch.

Comentários

A tabela a seguir identifica as cadeias de caracteres de propriedade de criação de patch que podem ser inseridas na Tabela de propriedades do arquivo .pcp.

Propriedade Descrição
AllowLaxValidationFlags Se essa propriedade for definida como 1, uma entrada será gravada no log e nenhum erro será retornado se o campo ProductValidateFlags na tabela TargetImages não puder ser validado. Essa propriedade só deve ser definida quando o autor do patch tiver alterado o valor no campo ProductValidateFlags. O valor padrão para essa propriedade é 0. Disponível a partir de Patchwiz.dll versão 4.0.
AllowProductCodeIncompatibilidades Defina como '1' para True se o ProductCode Property puder diferir entre as imagens atualizadas listadas na da Tabela UpgradedImages e as imagens de destino listadas na Tabela TargetImages. Defina como '0' ou em branco para significar Falso se os códigos do produto tiverem de ser os mesmos.
AllowProductVersionMajorMismatches Defina como '1' para significar True se o primeiro campo (o campo da versão principal) da ProductVersion Property puder diferir entre imagens atualizadas e imagens de destino. Defina como '0' ou em branco para significar Falso se as versões principais tiverem de corresponder.
ApiPatchingSymbolFlags Um inteiro hexadecimal de 8 dígitos que representa a combinação de sinalizadores de uso de símbolos de patch a serem usados ao criar um patch de arquivo binário. O padrão é 0x00000000. Consulte Patchapi.h para obter a lista completa de possíveis sinalizadores PATCH_SYMBOL_*. Consulte o glossário para obter mais informações sobre arquivos de símbolos.
DontRemoveTempFolderWhenFinished Defina como '1' para significar True se a pasta temporária que contém as transformações, os patches de nível de byte e os novos arquivos inteiros não estiverem sendo removidos após a criação do pacote de patch. Este é essencialmente o conteúdo do arquivo .msp antes de ser incorporado no pacote de patch. Isso pode ser útil para depurar patches. Defina como '0' ou em branco para significar Falso se a pasta temporária for removida.
IncludeWholeFilesOnly Definido como '1' para significar True se os arquivos que estão sendo alterados devem ser incluídos em sua totalidade ao criar o pacote de patch em vez de criar um patch de arquivo binário. Os arquivos de patch serão maiores em tamanho, mas a API é executada mais rapidamente. Defina como '0' ou em branco para significar False se estiver criando um patch de arquivo binário.
ListOfPatchGUIDsToReplace Uma lista de identificadores PatchGUID sem delimitador. Se algum desses patches for encontrado instalado no computador do usuário e registrado no Windows Installer, eles não serão registrados no produto apropriado e suas transformações de patch serão removidas da lista de transformações associadas ao produto. Note que a remoção de um patch não afeta nenhum dos ficheiros, apenas o registo do patch. Opcional.
ListOfTargetProductCodes Uma lista de códigos de produto para produtos que podem receber esse patch. Esta é uma lista delimitada por ponto-e-vírgula de ProductCode valores de propriedade. Se a lista começar com um asterisco, a lista de códigos de produto será gerada a partir dos arquivos de .msi dos destinos listados na Tabela TargetImages. Se algum código de produto seguir um asterisco principal, ele será anexado à lista que substitui o asterisco. Se a propriedade não estiver definida, uma lista de códigos de produto será gerada a partir dos arquivos de .msi dos destinos listados no Tabela TargetImages.
MsiFileToUseToCreatePatchTables O caminho completo para um modelo .msi arquivo do qual exportar o Patch Table e PatchPackage Table. Opcional.A Tabela de Propriedades aceita variáveis de ambiente para caminhos que começam com a versão 4.0 do Patchwiz.dll. Use o formato do Windows para a variável de ambiente, como %ENV_VAR%. Não use o tipo de dados Formatado coluna.
OptimizePatchSizeForLargeFiles Esta propriedade é definida quando o valor existe e não é "0". Quando essa propriedade é definida, patches para arquivos com mais de aproximadamente 4 MB de tamanho podem ser reduzidos.
PatchGUID Um GUID identificador para este pacote de patch (arquivo .msp). Cada pacote de patch deve ter um valor PatchGUID exclusivo. Necessário.
PatchOutputPath O caminho completo, incluindo o nome do arquivo, do arquivo do pacote de patch a ser gerado. Se szPatchPath for passado pela função UiCreatePatchPackageEx, o valor passado será usado. Essa propriedade é necessária se szPatchPath for null ou uma cadeia de caracteres vazia. A Tabela de propriedades aceita variáveis de ambiente para caminhos que começam com a versão 4.0 do Patchwiz.dll. Use o formato do Windows para a variável de ambiente, como %ENV_VAR%. Não use o tipo de dados Formatado coluna.
PatchSourceList Uma fonte usada para localizar o arquivo .msp para o patch no caso de a cópia armazenada em cache local não estar disponível. Esse valor é adicionado à lista de origem do patch quando ele é aplicado a um produto. Opcional.
MinimumRequiredMsiVersion Defina essa propriedade para forçar Patchwiz.dll a gerar um patch que exija uma versão específica do Windows Installer. Esse valor de propriedade ajuda a determinar qual valor usar para o Word Count Summary Property do pacote de patch. O valor para essa propriedade é da mesma forma que o Page Count Summary Property do pacote de instalação. Se um arquivo .pcp tiver um MinimumRequiredMsiVersion igual a 200, Patchwiz.dll definirá a propriedade Word Count Summary do pacote de patch como 3. Isso impede que o patch seja aplicado pela versão do Windows Installer anterior à versão 2.0.
Se um arquivo .pcp tiver um MinimumRequiredMsiVersion igual a 300, Patchwiz.dll definirá a propriedade Word Count Summary do pacote de patch como 4. Isso impede que o patch seja aplicado por versões do Windows Installer anteriores à versão 3.0.
Se um arquivo .pcp tiver um MinimumRequiredMsiVersion igual a 310, Patchwiz.dll definirá a propriedadeWord Count Summary do pacote de patch como 5. Isso impede que o patch seja aplicado pelo Windows Installer antes da versão 3.1.
Se um arquivo .pcp tiver um MinimumRequiredMsiVersion igual a 400, Patchwiz.dll definirá a propriedade Word Count Summary do pacote de patch como 6. Isso impede que o patch seja aplicado pelo Windows Installer antes da versão 4.0.
PATCH_CACHE_ENABLED Defina essa propriedade como 1 para armazenar em cache as informações de criação do patch na pasta especificada pela propriedade PATCH_CACHE_DIR. O cache de patches aumenta a velocidade de criação de patches ao recriar um novo patch após a atualização da imagem de atualização. Esta propriedade requer Patchwiz.dll no Windows Installer 2.0 ou posterior. Para obter informações, consulte Patch Information Caching (Patchwiz.dll).
PATCH_CACHE_DIR Defina essa propriedade como o nome da pasta que armazena as informações de patch armazenadas em cache. Patchwiz.dll cria esta pasta, se necessário. A pasta deve estar em uma unidade com espaço em disco suficiente. Esta propriedade só é usada se a propriedade PATCH_CACHE_ENABLED estiver definida como 1. A Tabela de propriedades aceita variáveis de ambiente para caminhos que começam com a versão 4.0 do Patchwiz.dll. Use o formato do Windows para a variável de ambiente, como %ENV_VAR%. Não use o tipo de dados Formatado coluna.
SEQUENCE_DATA_GENERATION_DISABLED Defina essa propriedade como 1 (um) para impedir a geração automática de informações de sequenciamento de patches. Se essa propriedade estiver ausente, as informações de sequenciamento serão geradas e adicionadas automaticamente.
SEQUENCE_DATA_SUPERSEDENCE Defina essa propriedade como 0 (zero) ou 1 (um) para gravar esse valor no campo Atributos de todas as linhas da tabela MsiPatchSequence.
TrustMsi Defina essa propriedade como 1 na Tabela de propriedades para usar as informações de versão do arquivo, tamanho e valores de hash fornecidos no arquivo .msi. Se essa propriedade estiver definida, mas as informações no arquivo .msi estiverem incorretas, o patch criado pode não funcionar corretamente. Você deve atualizar os arquivos de destino e .msi atualizados usando MsiFiler.exe. O valor padrão para essa propriedade é 0. Disponível a partir de Patchwiz.dll versão 4.0.