Partilhar via


Tabela de atualização

A tabela Atualizar contém informações necessárias durante principais atualizações. Para habilitar totalmente os recursos de atualização do instalador, cada pacote deve ter uma propriedade UpgradeCode e uma tabela Upgrade. Cada registro na tabela Upgrade fornece uma combinação característica de código de atualização, versão do produto e informações de idioma usadas para identificar um conjunto de produtos afetados pela atualização. Quando a ação FindRelatedProducts deteta um produto afetado instalado no sistema, ela acrescenta o código do produto a uma propriedade especificada na coluna ActionProperty. A ação RemoveExistingProducts e a ação MigrateFeatureStates removem ou migram apenas produtos listados na coluna ActionProperty.

A tabela Atualizar contém as colunas mostradas na tabela a seguir.

Coluna Tipo Chave Nulo
Código de atualização GUID Y N
VersãoMin de texto Y Y
VersãoMax de texto Y Y
Idioma de texto Y Y
Atributos inteiro Y N
Remover Formatado N Y
ActionProperty Identificador N N

 

Colunas

UpgradeCode

A propriedade UpgradeCode nesta coluna especifica o código de atualização de todos os produtos que devem ser detetados pela ação FindRelatedProducts.

VersionMin

Limite inferior da gama de versões de produtos detetados por FindRelatedProducts. Insira msidbUpgradeAttributesVersionMinInclusive em Atributos para incluir VersionMin no intervalo. Se VersionMin for igual a uma string vazia ("") ela será avaliada da mesma forma que 0. Se VersionMin for null, FindRelatedProducts ignorará msidbUpgradeAttributesVersionMinInclusive e detetará todas as versões anteriores. VersionMin e VersionMax não devem ser ambos nulos.

VersionMin deve ser uma versão válida do produto, conforme descrito para a propriedadeProductVersion. Observe que o Windows Installer usa apenas os três primeiros campos da versão do produto. Se você incluir um quarto campo na versão do produto, o instalador ignorará o quarto campo.

VersionMax

Limite superior da gama de versões de produtos detetada pela ação FindRelatedProducts. Insira msidbUpgradeAttributesVersionMaxInclusive em Atributos para incluir VersionMax no intervalo. Se VersionMax for uma string vazia (""), ela será avaliada da mesma forma que 0. Se VersionMax for null, FindRelatedProducts ignorará msidbUpgradeAttributesVersionMaxInclusive e detetará todas as versões do produto maiores que (ou maiores ou iguais a) o limite inferior especificado por VersionMin e msidbUpgradeAttributesVersionMinInclusive. VersionMin e VersionMax não devem ser ambos nulos.

VersionMax deve ser uma versão válida do produto, conforme descrito para a propriedade ProductVersion. Observe que o Windows Installer usa apenas os três primeiros campos da versão do produto. Se você incluir um quarto campo na versão do produto, o instalador ignorará o quarto campo.

Língua

O conjunto de idiomas detetados pelo FindRelatedProducts. Insira uma lista de identificadores numéricos de idioma (LANGID) separados por vírgulas. Digite msidbUpgradeAttributesLanguagesExclusive em Atributos para detetar todos os idiomas exclusivos daqueles listados em Idioma. Se Language for null ou uma string vazia (""), FindRelatedProducts ignorará msidbUpgradeAttributesLanguagesExclusive e detetará todos os idiomas.

Atributos

Esta coluna contém sinalizadores de bits especificando atributos da tabela Upgrade.

Nome do sinalizador de bits Decimal Hexadecimal Atributo
msidbUpgradeAttributesMigrateFeatures 1 0x001 Migra estados de recursos habilitando a lógica na ação MigrateFeatureStates.
msidbUpgradeAttributesOnlyDetect 2 0x002 Deteta produtos e aplicativos, mas não remove.
msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Continua a instalação após a falha ao remover um produto ou aplicativo.
msidbUpgradeAttributesVersionMinInclusive 256 0x100 Deteta o intervalo de versões, incluindo o valor em VersionMin.
msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Deteta o intervalo de versões, incluindo o valor em VersionMax.
msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Deteta todos os idiomas, excluindo os listados na coluna Idioma.

 

Remover

O instalador define a propriedade REMOVE como recursos especificados nesta coluna. Os recursos a serem removidos podem ser determinados em tempo de execução. A cadeia de caracteres Formatado inserida neste campo deve ser avaliada de acordo com uma lista delimitada por vírgulas de nomes de recursos. Por exemplo: [Feature1],[Feature2],[Feature3]. Nenhum recurso será removido se o campo contiver texto formatado avaliado como uma cadeia de caracteres vazia (""). O instalador define REMOVE=ALL somente se o campo Remover estiver vazio. Observe a diferença entre uma cadeia de caracteres vazia e um campo vazio. Se o campo estiver vazio, é nulo.

ActionProperty

Quando a ação FindRelatedProducts deteta um produto relacionado instalado no sistema, ela acrescenta o código do produto à propriedade especificada neste campo. A propriedade especificada nesta coluna deve ser uma propriedade pública e o autor do pacote deve adicionar a propriedade à propriedadeSecureCustomProperties. Cada linha na tabela Upgrade deve ter um valor ActionProperty exclusivo. Depois de FindRelatedProducts, o valor dessa propriedade é uma lista de códigos de produto, separados por ponto-e-vírgula (;), detetados no sistema.

Validação

ICE03
ICE06
ICE46
ICE61
ICE66