Tabela MsiEmbeddedChainer
Use esta tabela para criar um instalação de vários pacotes. Cada linha na tabela MsiEmbeddedChainer faz referência a uma função diferente definida pelo usuário que pode ser usada para instalar vários pacotes do Windows Installer a partir de um único pacote. Os arquivos executáveis para as funções definidas pelo usuário são armazenados dentro do pacote do Windows Installer.
Windows Installer 4.0 ou anterior: Não suportado. Esta tabela está disponível a partir do Windows Installer 4.5.
Windows Server 2008 R2 com a função Serviços de Área de Trabalho Remota habilitada: Não suportado. Uma instalação de vários pacotes usando a tabela MsiEmbeddedChainer falhará se a função Serviços de Área de Trabalho Remota estiver habilitada.
Para instalar vários pacotes de um único pacote, uma das funções definidas pelo usuário listadas na tabela MsiEmbeddedChainer deve ter uma instrução condicional no campo Condition que avalia para executar a ação. Se mais de uma função tiver uma condição que avalia para ser executada, apenas uma função poderá ser executada. Este caso é um erro, e não é possível garantir qual função será executada. Se outras ações personalizadas forem necessárias para a instalação, elas deverão ser criadas nas tabelas e sequência da tabela CustomAction.
As funções devem ingressar na instalação atual chamando a funçãoMsiJoinTransaction e devem chamar a funçãoMsiEndTransactionpara confirmar a instalação de vários pacotes. Se as funções retornarem antes de chamar MsiEndTransaction, o instalador reverterá todas as instalações.
A tabela MsiEmbeddedChainer tem as seguintes colunas.
| Coluna | Tipo | Chave | Nulo |
|---|---|---|---|
| MsiEmbeddedChainer | Identificador | Y | N |
| Condição | Condição | N | Y |
| Linha de comando | Formatado | N | Y |
| Fonte | CustomSource | N | N |
| Tipo | inteiro | N | N |
Colunas
-
MsiEmbeddedChainer
-
A chave primária para a tabela. Esse valor é um identificador exclusivo para a função definida pelo usuário descrita por esta linha.
-
Condição
-
Uma instrução condicional para executar a função definida pelo usuário. Você pode habilitar ou desabilitar as funções listadas na tabela MsiEmbeddedChainer usando uma transformação que modifica os valores de propriedade avaliados por esse campo. Para obter mais informações, consulte Usando propriedades em instruções condicionais.
-
Linha de comando
-
O valor neste campo é uma parte da cadeia de caracteres de linha de comando passada para o arquivo executável identificado na coluna Source. O instalador acrescenta o valor neste campo ao identificador de transação para gerar a linha de comando. Se o valor nesta coluna for null, a linha de comando consistirá apenas no identificador de transação.
-
Fonte
-
O local do arquivo executável para a função definida pelo usuário. Se o valor na coluna Tipo for 2, esta coluna pode conter uma chave externa na tabela Binary,. Se o valor na coluna Tipo for 18, essa coluna poderá conter uma chave externa na tabela Arquivo . Se o valor na coluna Tipo for 50, essa coluna poderá conter uma chave externa na tabela Propriedade .
-
Tipo
-
As funções listadas na tabela MsiEmbeddedChainer são descritas usando os seguintes tipos numéricos de ação personalizada. Esta coluna pode conter apenas os valores para os três tipos numéricos seguintes; qualquer outra combinação de sinalizadores de ação personalizados é ignorada.
Tipo de ação personalizada Sinalizadores de ação personalizados Hexadecimal Decimal Ação personalizada Tipo 2 msidbCustomActionTypeExe + msidbCustomActionTypeBinaryData 0x002 2 Ação personalizada Tipo 18 msidbCustomActionTypeExe + msidbCustomActionTypeFile 0x012 18 Ação Personalizada Tipo 50 msidbCustomActionTypeExe + msidbCustomActionTypeProperty 0x032 50
Comentários
O Windows Installer não impede que as funções definidas pelo usuário nesta tabela sejam executadas durante o anúncio do aplicativo. Você pode usar uma instrução condicional na coluna Condição para impedir que uma função seja executada durante o anúncio.
O Windows Installer também fornece um manipulador de interface do usuário externo não incorporado para criar uma interface de usuário avançada sobre o pacote do Windows Installer. Para obter mais informações sobre como usar um manipulador de interface do usuário externo com o Windows Installer, consulte Monitorando uma instalação usando MsiSetExternalUI.
A tabela MsiPackageCertificate lista os certificados de assinatura digital usados para verificar a identidade dos pacotes de instalação que fazem uma instalação de vários pacotes. Você pode usar esta tabela para reduzir o número de vezes que a instalação de vários pacotes exibe um prompt UAC ( de Controle de Conta de Usuário) que requer uma resposta de um administrador.