Tabela PatchMetadata (PATCHWIZ.DLL)

  • Artigo

A tabela PatchMetadata contém informações sobre um patch do Windows Installer necessário para remover um patch e que é usado para Adicionar/Remover Programas. Todas as propriedades na tabela PatchMetadata são adicionadas à tabela MsiPatchMetadata do arquivo .msp para um patch.

A tabela PatchMetadata é necessária em arquivos de propriedades de criação de patch (arquivos .pcp) que têm um MinimumRequiredMsiVersion igual a 300 na tabela Propriedades. A tabela será opcional se MinimumRequiredMsiVersion não for igual a 300.

A tabela PatchMetadata tem as colunas a seguir.

Coluna Tipo Chave Nullable
Empresa text S S
Propriedade text S N
Valor text S

 

Colunas

Company

O nome da empresa. Um campo vazio (um valor Null) indica que essa linha contém uma das propriedades de metadados padrão. Uma empresa pode estender o conjunto de propriedades adicionando uma linha à tabela e inserindo um nome de empresa nesse campo.

Propriedade

O nome de uma propriedade de metadados. As propriedades AllowRemoval, ManufacturerName, TargetProductName, MoreInfoURL, DisplayName, Description e Classification são necessárias na tabela PatchMetadata. Esse campo deverá conter uma das seguintes propriedades de metadados padrão se o campo Empresa estiver vazio (um valor Null).

Propriedade Descrição
AllowRemoval Um valor inteiro que indica se o patch é ou não um Patch Desinstalável. Se o campo Valor contiver um 0 (zero), o patch não poderá ser removido. Se o campo Valor contiver 1 (um), o patch será um Patch Desinstalável. Essa propriedade é necessária. Essa propriedade é registrada e seu valor pode ser obtido usando a função MsiGetPatchInfoEx.
ManufacturerName Um valor de cadeia de caracteres que contém o nome do fabricante do aplicativo. Esta propriedade é necessária.
MinorUpdateTargetRTM Indica que o patch tem como destino a versão RTM do produto ou o patch de atualização principal mais recente. Crie essa propriedade opcional em patches de atualização secundários que contenham informações de sequenciamento para indicar que o patch é removido de todos os patches até a versão RTM do produto ou até o principal e mais recente patch de atualização. Essa propriedade está disponível a partir do Windows Installer 3.1. Nota: Para exigir que o Windows Installer 3.1 seja instalado para aplicar o patch, defina a propriedade MinimumRequiredMsiVersion como 310 na Tabela de Propriedades do arquivo .pcp.
TargetProductName Um valor de cadeia de caracteres que contém o nome do aplicativo ou do pacote de aplicativos de destino. Esta propriedade é necessária.
MoreInfoURL Um valor de cadeia de caracteres que contém uma URL indicando informações para esse patch. Essa propriedade necessária é registrada e seu valor pode ser obtido usando a função MsiGetPatchInfoEx. A partir do Windows XP com Service Pack 2 (SP2), esse valor pode ser o link de suporte para o patch exibido em Adicionar/Remover Programas.
CreationTimeUTC Um valor de cadeia de caracteres que contém a hora de criação do arquivo .msp no formato mm-dd-yy HH:MM (mês-dia-ano hora:minuto). Essa propriedade é opcional.
DisplayName Um valor de cadeia de caracteres que contém o título do patch adequado para exibição pública. Esta propriedade é necessária. Essa propriedade é registrada e seu valor pode ser obtido usando a função MsiGetPatchInfoEx. A partir do Windows XP com SP2, esse valor é o nome do patch exibido em Adicionar/Remover Programas.
Descrição Um valor de cadeia de caracteres que contém uma breve descrição do patch. Esta propriedade é necessária.
classificação Um valor de cadeia de caracteres que contém a categoria arbitrária de atualizações, conforme definido pelo autor do patch. Por exemplo, os autores de patch podem especificar que cada patch seja classificado como um Hotfix, Pacote Cumulativo de Atualizações de Segurança, Atualização Crítica, Atualização, Service Pack ou Pacote Cumulativo de Atualizações. Esta propriedade é necessária.
OptimizedInstallMode Se essa propriedade for definida como 1 (um) em todos os patches a serem aplicados em uma transação, o aplicativo do patch será otimizado, se possível. Para obter informações, confira Otimização de patch. Disponível a partir do Windows Installer 3.1.

 

Value

Valor da propriedade de metadados. Isso nunca pode ser Null ou uma cadeia de caracteres vazia. Esse valor pode ser localizado.

Comentários

Disponível a partir do Windows Installer 3.0.

Todas as propriedades criadas na tabela PatchMetadata são adicionadas à tabela MsiPatchMetadata do arquivo msp. As propriedades AllowRemoval, MoreInfoURL e DisplayName são registradas e podem ser acessadas por meio do MsiGetPatchInfoEx.