Share via

Database.CreateTransformSummaryInfo method

  • Artigo

O método CreateTransformSummaryInfo do objeto Database cria e preenche o fluxo de informações de resumo de um arquivo de transformação existente. Esse método preenche as propriedades com a base e a referência ProductCode e ProductVersion.

Sintaxe

Database.CreateTransformSummaryInfo(
  reference,
  storage,
  errorConditions,
  validation
)

Parâmetros

reference

Banco de dados necessário que não inclui as alterações.

storage

O nome do arquivo de transformação gerado. Isso é opcional.

errorConditions

Condições de erro necessárias que devem ser suprimidas quando a transformação é aplicada. Combine um ou mais dos seguintes valores de condição de erro.

Nome da condição de erro Significado
msiTransformErrorNone
0
 Nenhuma das condições a seguir.
msiTransformErrorAddExistingRow
1
 Adiciona uma linha que já existe.
msiTransformErrorDeleteNonExistingRow
2
 Exclui uma linha que não existe.
msiTransformErrorAddExistingTable
4
 Adiciona uma tabela que já existe.
msiTransformErrorDeleteNonExistingTable
8
 Exclui uma tabela que não existe.
msiTransformErrorUpdateNonExistingRow
16
 Atualiza uma linha que não existe.
msiTransformErrorChangeCodepage
32
 As páginas de código de transformação e de banco de dados não correspondem e nenhuma página de códigos é neutra.

validation

Necessária quando a transformação é aplicada a um banco de dados. Mostra quais propriedades devem ser validadas para verificar se essa transformação pode ser aplicada ao banco de dados. Todas as propriedades constam no Conjunto de propriedades do fluxo de informações de resumo.

Combine um ou mais dos seguintes valores.

Sinalizador de validação Significado
msiTransformValidationNone
0
 Nenhuma validação realizada.
msiTransformValidationLanguage
1
 O idioma padrão deve corresponder ao banco de dados base.
msiTransformValidationProduct
2
 O produto deve corresponder ao banco de dados base.

Para validar a versão do produto, primeiro escolha um ou mais desses três sinalizadores para indicar quais versões devem ser verificadas.

Sinalizador de validação Significado
msiTransformValidationMajorVer
8
 Verifica somente a versão principal.
msiTransformValidationMinorVer
16
 Verifica somente a versão principal e secundária.
msiTransformValidationUpdateVer
32
 Verifica as versões principal, secundária e de atualização.

Em seguida, escolha uma das opções a seguir para indicar a relação necessária entre a versão do produto do banco de dados à qual a transformação está sendo aplicada e a do banco de dados base.

Sinalizador de validação Significado
msiTransformValidationLess
64
 Versão aplicada < versão base
msiTransformValidationLessOrEqual
128
 Versão aplicada <= versão base
msiTransformValidationEqual
256
 Versão aplicada = versão base
msiTransformValidationGreaterOrEqual
512
 Versão aplicada >= versão base
msiTransformValidationGreater
1024
 Versão aplicada > versão base

Para validar se a transformação está sendo aplicada a um pacote com a UpgradeCode apropriada, defina o sinalizador a seguir.

Sinalizador de validação Significado
msiTransformValidationUpgradeCode
2.048
 Valida se a transformação é a UpgradeCode apropriada.

Valor retornado

Esse método não retorna um valor.

Comentários

Para criar um fluxo de informações de resumo para uma transformação, as propriedades ProductCode e ProductVersion devem ser definidas nas tabelas Property dos bancos de dados base e de referência. Se msiTransformValidationUpgradeCode for usado, a propriedade UpgradeCode deverá ser definida nos dois bancos de dados.

Requisitos

Requisito Valor
Versão
 Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
 O IID_IDatabase é definido como 000C109D-0000-0000-C000-000000000046

Confira também

Transformações de banco de dados