Função MsiCreateTransformSummaryInfoA (msiquery.h)
A função MsiCreateTransformSummaryInfo cria informações resumidas de uma transformação existente para incluir condições de validação e erro. A execução dessa função define o registro de erro, que é acessível usando MsiGetLastErrorRecord.
Sintaxe
UINT MsiCreateTransformSummaryInfoA(
[in] MSIHANDLE hDatabase,
[in] MSIHANDLE hDatabaseReference,
[in] LPCSTR szTransformFile,
[in] int iErrorConditions,
[in] int iValidation
);
Parâmetros
[in] hDatabase
O identificador para o banco de dados que contém as novas informações de resumo do banco de dados.
[in] hDatabaseReference
O identificador para o banco de dados que contém as informações de resumo originais.
[in] szTransformFile
O nome da transformação à qual as informações de resumo são adicionadas.
[in] iErrorConditions
As condições de erro que devem ser suprimidas quando a transformação é aplicada. Use um ou mais dos valores a seguir.
[in] iValidation
Especifica as propriedades a serem validadas para verificar se a transformação pode ser aplicada ao banco de dados. Esse parâmetro pode usar um dos valores a seguir.
Validar sinalizadores de versão do produto.
Sinalizadores de relação de versão do produto. Na tabela a seguir, a versão instalada é a versão do pacote que está sendo transformado e a versão base é a versão do pacote que é usada para criar a transformação.
Atualizar sinalizadores de validação de código.
| Sinalizador de validação | Significado |
|---|---|
|
UpgradeCode deve corresponder ao banco de dados base. |
Retornar valor
Essa função retorna UINT.
Comentários
A Propriedade ProductCode e a Propriedade ProductVersion devem ser definidas na Tabela de Propriedades dos bancos de dados base e de referência. Se MSITRANSFORM_VALIDATE_UPGRADECODE for usado, a Propriedade UpgradeCode também deverá ser definida em ambos os bancos de dados. Se essas condições não forem atendidas, MsiCreateTransformSummaryInfo retornará ERROR_INSTALL_PACKAGE_INVALID.
- Não use o ponto e vírgula para nomes de arquivo ou caminhos, pois ele é usado como um delimitador de lista para transformações, fontes e patches.
- Essa função não pode ser chamada de ações personalizadas. Uma chamada para essa função de uma ação personalizada faz com que a função falhe.
Observação
O cabeçalho msiquery.h define MsiCreateTransformSummaryInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | 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 |
| Plataforma de Destino | Windows |
| Cabeçalho | msiquery.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |