Compartilhar via


Tabela de atualização

A tabela Atualização contém informações necessárias durante atualizações principais. 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 De atualização 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 detecta um produto afetado instalado no sistema, ele acrescenta o código do produto a uma propriedade especificada na coluna ActionProperty. A ação RemoveExistingProducts e a ação MigrateFeatureStates apenas remover ou migrar produtos listados na coluna ActionProperty.

A tabela De atualização contém as colunas mostradas na tabela a seguir.

Coluna Tipo Chave Nullable
UpgradeCode guid do Y N
VersionMin de Texto Y Y
VersionMax de Texto Y Y
Idioma de Texto Y Y
Atributos inteiro Y N
Retirar Formatado N Y
ActionProperty identificador de N N

 

Colunas

UpgradeCode

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

VersionMin

Limite inferior do intervalo de versões do produto detectadas por FindRelatedProducts. Insira msidbUpgradeAttributesVersionMinInclusive em Atributos para incluir VersionMin no intervalo. Se VersionMin for igual a uma cadeia de caracteres vazia ("") ela será avaliada da mesma forma que 0. Se VersionMin for nulo, FindRelatedProducts ignorará msidbUpgradeAttributesVersionMinInclusive e detectará todas as versões anteriores. VersionMin e VersionMax não devem ser 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 do intervalo de versões do produto detectadas pela ação FindRelatedProducts. Insira msidbUpgradeAttributesVersionMaxInclusive em Atributos para incluir VersionMax no intervalo. Se VersionMax for uma cadeia de caracteres vazia (""), ela será avaliada da mesma forma que 0. Se VersionMax for nulo, FindRelatedProducts ignorará msidbUpgradeAttributesVersionMaxInclusive e detectará 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 nulos.

VersionMax 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.

Idioma

O conjunto de idiomas detectado por FindRelatedProducts. Insira uma lista de LANGID (identificadores de idioma numérico) separados por vírgulas. Insira msidbUpgradeAttributesLanguagesExclusive em Atributos para detectar todos os idiomas exclusivos daqueles listados em Idioma. Se Language for nulo ou uma cadeia de caracteres vazia (""), FindRelatedProducts ignorará msidbUpgradeAttributesLanguagesExclusive e detectará todos os idiomas.

Atributos de

Esta coluna contém sinalizadores de bits especificando atributos da tabela De atualização.

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

 

Remover

O instalador define a propriedade REMOVE para os recursos especificados nesta coluna. Os recursos a serem removidos podem ser determinados em tempo de execução. A cadeia de caracteres formatada inserida nesse campo deve ser avaliada como 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 que é 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, ele será nulo.

ActionProperty

Quando a ação FindRelatedProducts detecta um produto relacionado instalado no sistema, ele 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 à propriedade SecureCustomProperties. Cada linha na tabela De atualização deve ter um valor exclusivo do ActionProperty. Depois de FindRelatedProducts, o valor dessa propriedade é uma lista de códigos de produto, separados por ponto-e-vírgula (;), detectados no sistema.

Validação

ICE03
ICE06
ICE46
ICE61
ICE66