Compartilhar via


Tabela Properties (Patchwiz.DLL)

A tabela Properties contém configurações globais do pacote de patch. A tabela Properties é obrigatória no banco de dados de criação de patch (arquivo .pcp) e é usada pela função UiCreatePatchPackageEx.

A Tabela de Propriedades tem as colunas a seguir.

Coluna Tipo Chave Nullable
Nome text S N
Valor text S

 

Colunas

Name

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

Value

O valor da propriedade de criação de 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 Properties do arquivo .pcp.

Propriedade Descrição
AllowLaxValidationFlags Se essa propriedade for definida como 1, uma entrada é gravada no log e nenhum erro é retornado se o campo ProductValidateFlags na tabela TargetImages não puder ser validada. Essa propriedade só deve ser definida quando o criador do patch tiver alterado o valor no campo ProductValidateFlags. O valor padrão para essa propriedade é 0. Disponível a partir da versão 4.0 do Patchwiz.dll.
AllowProductCodeMismatches Defina como ‘1’ para True se a propriedade ProductCode puder ser diferente entre as imagens atualizadas listadas na Tabela UpgradedImages e as imagens de destino listadas na Tabela TargetImages. Defina como '0' ou em branco para significar False se os códigos do produto precisarem ser os mesmos.
AllowProductVersionMajorMismatches Defina como ‘1’ para significar True se o primeiro campo (o campo da versão principal) da propriedade ProductVersion puder ser diferente entre as imagens atualizadas e as imagens de destino. Defina como '0' ou em branco para significar False se as versões principais precisarem corresponder.
ApiPatchingSymbolFlags Um inteiro hexadecimal de 8 dígitos que representa a combinação de sinalizadores de uso de símbolo de patch a serem usados na criação de um patch de arquivo binário. O padrão é 0x00000000. Veja Patchapi.h para obter uma lista completa de sinalizadores possíveis de PATCH_SYMBOL_*. Confira o glossário para obter mais informações sobre arquivos de símbolo.
DontRemoveTempFolderWhenFinished Defina como '1' para significar True se a pasta temporária que contém as transformações, os patches no nível de byte e todos os novos arquivos não estiver sendo removida após a criação do pacote de patch. Isso é essencialmente o conteúdo do arquivo .msp antes de ser inserido no pacote de patch. Isso pode ser útil para depurar patches. Defina como '0' ou em branco para significar False se a pasta temporária for removida.
IncludeWholeFilesOnly Defina 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 será 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 estiver instalado no computador do usuário e registrado no Windows Installer, eles serão cancelados no produto apropriado e suas transformações de patch serão removidas da lista de transformações associadas ao produto. Observe que a remoção de um patch não afeta nenhum dos arquivos, apenas o registro do patch. Opcional.
ListOfTargetProductCodes Uma lista de Códigos de Produto que podem receber esse patch. É uma lista separada por ponto e vírgula de valores da propriedade ProductCode. Se a lista começar com um asterisco, a lista de códigos de produto será gerada dos arquivos .msi dos destinos listados na tabela TargetImages. Se algum código de produto seguir um asterisco à esquerda, eles serão acrescentados à lista que substitui o asterisco. Se a propriedade não for definida, uma lista de códigos de produto será gerada dos arquivos .msi dos destinos listados na tabela TargetImages.
MsiFileToUseToCreatePatchTables O caminho completo para um arquivo .msi de modelo do qual exportar as tabelas Patch e PatchPackage. Opcional. A Tabela de Propriedades aceita variáveis de ambiente para caminhos que começam com a versão 4.0 de Patchwiz.dll. Use o formato do Windows na variável de ambiente, por exemplo, %ENV_VAR%. Não use o tipo de dados da coluna Formatted.
OptimizePatchSizeForLargeFiles Essa propriedade é definida quando o valor existe e não é "0". Quando essa propriedade é definida, os patches para arquivos com mais de aproximadamente 4 MB de tamanho podem ficar menores.
PatchGUID Um identificador GUID para esse pacote de patch (arquivo .msp). Cada pacote de patch precisa ter um valor patchGUID exclusivo. Obrigatórios.
PatchOutputPath O caminho completo, incluindo o nome do arquivo de pacote de patch que deve ser gerado. Se szPatchPath for transmitido pela função UiCreatePatchPackageEx, o valor transmitido será usado. A propriedade é obrigató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 de Patchwiz.dll. Use o formato do Windows na variável de ambiente, por exemplo, %ENV_VAR%. Não use o tipo de dados da coluna Formatted.
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 requer uma versão específica do Windows Installer. Esse valor da propriedade ajuda a adeterminar qual valor usar na propriedade Word Count Summary do pacote de patch. O valor dessa propriedade é do mesmo formulário da propriedade Page Count Summary do pacote de instalação. Se um arquivo .pcp tem uma MinimumRequiredMsiVersion igual a 200, Patchwiz.dll define a propriedade Word Count Summary do pacote como 3. Isso impede que o patch seja aplicado pela versão do Windows Installer anterior à versão 2.0.
Se um arquivo .pcp tem uma MinimumRequiredMsiVersion igual a 300, Patchwiz.dll define a propriedade Word Count Summary do pacote como 4. Isso impede que o patch seja aplicado pela versão do Windows Installer anterior à versão 3.0.
Se um arquivo .pcp tem uma MinimumRequiredMsiVersion igual a 310, Patchwiz.dll define a propriedade Word Count Summary do pacote como 5. Isso impede que o patch seja aplicado pelo Windows Installer anterior à versão 3.1.
Se um arquivo .pcp tem uma MinimumRequiredMsiVersion igual a 400, Patchwiz.dll define a propriedade Word Count Summary do pacote como 6. Isso impede que o patch seja aplicado pelo Windows Installer anterior à versão 4.0.
PATCH_CACHE_ENABLED Defina essa propriedade como 1 para armazenar em cache as informações de criação de patch na pasta especificada pela propriedade PATCH_CACHE_DIR. O cache de patch aumenta a velocidade de criação de patch ao recriar um novo patch depois de atualizar a imagem de atualização. Essa propriedade requer Patchwiz.dll no Windows Installer 2.0 ou posterior. Para obter mais informações, confira Cache de informações de patch (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 essa pasta, se necessário. A pasta deve estar em uma unidade com espaço em disco suficiente. Essa propriedade só é usada se a PATCH_CACHE_ENABLED está definida como 1. A Tabela de Propriedades aceita variáveis de ambiente para caminhos que começam com a versão 4.0 de Patchwiz.dll. Use o formato do Windows na variável de ambiente, por exemplo, %ENV_VAR%. Não use o tipo de dados da coluna Formatted.
SEQUENCE_DATA_GENERATION_DISABLED Defina essa propriedade como 1 (um) para impedir a geração automática de informações de sequenciamento de patch. 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 Attributes de todas as linhas na tabela MsiPatchSequence.
TrustMsi Defina essa propriedade como 1 na tabela Properties para usar as informações de versão do arquivo, o tamanho e os valores de hash fornecidos no arquivo .msi. Se essa propriedade estiver definida, mas as informações no arquivo .msi estiverem incorretas, o patch criado poderá não funcionar corretamente. Você deve atualizar os arquivos .msi de destino e atualizados usando MsiFiler.exe. O valor padrão para essa propriedade é 0. Disponível a partir da versão 4.0 do Patchwiz.dll.