Tabela PatchMetadata (PATCHWIZ.DLL)

A Tabela PatchMetadata contém informações sobre um patch do Windows Installer que é necessário para remover um patch e que é usado por 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 no da Tabela de Propriedades do. A tabela será opcional se MinimumRequiredMsiVersion não for igual a 300.

A Tabela PatchMetadata tem as colunas a seguir.

Coluna	Tipo	Chave	Nullable
Companhia	Texto	Y	Y
Propriedade	Texto	Y	N
Valor	Texto		Y

 

Colunas

Company

O nome da empresa. Um campo vazio (um valor Nulo) 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 neste 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 deve conter uma das seguintes propriedades de metadados padrão se o campo Empresa estiver vazio (um valor Nulo).

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. Essa 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 contêm informações de sequenciamento para indicar que o patch remove todos os patches até a versão RTM do produto ou até o patch de atualização principal mais recente. Essa propriedade está disponível a partir do Windows Installer 3.1. Observação: Para exigir que o Windows Installer 3.1 seja instalado para aplicar o patch, defina a propriedade MinimumRequiredMsiVersion como 310 no tabela de propriedades do do arquivo .pcp.
TargetProductName	Um valor de cadeia de caracteres que contém o nome do aplicativo ou do pacote de aplicativos de destino. Essa propriedade é necessária.
MoreInfoURL	Um valor de cadeia de caracteres que contém uma URL apontando para informações para este patch. Essa propriedade necessária é registrada e seu valor pode ser obtido usando a função MsiGetPatchInfoEx. Começando com o Windows XP com o 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 formulário 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. Essa propriedade é necessária. Essa propriedade é registrada e seu valor pode ser obtido usando a função MsiGetPatchInfoEx. Começando com o Windows XP com SP2, esse valor é o nome do patch exibido em Adicionar/Remover Programas começando com o Windows XP com SP2.
Descrição	Um valor de cadeia de caracteres que contém uma breve descrição do patch. Essa 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 Segurança, Atualização Crítica, Atualização, Service Pack ou Pacote cumulativo de atualizações. Essa 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, consulte de Otimização de Patch. Disponível a partir do Windows Installer 3.1.

 

Valor

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

Observações

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.