Objeto Session (Windows Installer)

O objeto Session controla o processo de instalação. Ele abre o banco de dados do Installer, que contém as tabelas e os dados de instalação. Esse objeto está associado a um conjunto padrão de funções de ação, cada uma executando operações específicas em dados de uma ou mais tabelas. Outras ações personalizadas podem ser adicionadas para instalações específicas do produto. A função básica do mecanismo é um sequenciador que busca registros sequenciais de uma tabela de sequência designada, avalia qualquer expressão de condição especificada e executa a ação designada. As ações não reconhecidas pelo mecanismo são adiadas para o objeto do manipulador de interface do usuário para processamento, geralmente sequências de caixas de diálogo.

Observe que apenas um objeto Session pode ser aberto por um único processo.

Membros

O objeto Session tem estes tipos de membros:

Métodos

O objeto Session tem estes métodos.

Método Descrição
DoAction Executa a ação especificada.
EvaluateCondition Avalia uma expressão lógica que contém símbolos e valores e retorna um inteiro da enumeração msiEvaluateConditionErrorEnum.
FeatureInfo Retorna um objeto FeatureInfo que contém informações descritivas do recurso especificado.
FormatRecord Retorna uma cadeia de caracteres formatada de dados de modelo e de registro.
Mensagem Executa todas as operações de log habilitadas e adia a execução para o objeto do manipulador de interface do usuário associado ao mecanismo.
Sequence Abre uma consulta na tabela especificada, ordenando as ações pelos números na coluna Sequence. Para cada linha buscada, o método DoAction é chamado, desde que qualquer expressão de condição fornecida não seja avaliada como False.
SetInstallLevel Define o nível de instalação da instalação atual como um valor especificado e recalcula os estados Selecionar e Instalado para todos os recursos.

 

Propriedades

O objeto Session tem estas propriedades.

Propriedade Tipo de acesso Descrição
ComponentCosts
Retorna um objeto RecordList enumerando o espaço em disco por unidade necessário para instalar um componente.
ComponentCurrentState
Retorna o estado atual instalado do componente designado.
ComponentRequestState
Obtém ou solicita uma alteração no estado Ação de uma linha na tabela Component.
Banco de dados
Retorna o banco de dados da sessão de instalação atual.
FeatureCost
Retorna a quantidade total de espaço em disco (em unidades de 512 bytes) exigida pelo recurso especificado e seus recursos pai (até a raiz da tabela Recurso).
FeatureCurrentState
Retorna o estado atual instalado do recurso designado.
FeatureRequestState
Leitura/gravação
Obtém ou solicita uma alteração no estado Selecionar do registro e sub-registros de um recurso.
FeatureValidStates
Retorna um inteiro que representa sinalizadores de bits com cada bit relevante que representa um estado de instalação válido para o recurso especificado.
Instalador
Retorna o objeto ativo do instalador.
Idioma (objeto Session)
Representa o identificador numérico de idiomas usado pela sessão de instalação atual.
Mode
Esta propriedade é um valor que representa o sinalizador de modo designado para a sessão de instalação atual.
ProductProperty
Representa o valor da cadeia de caracteres de uma propriedade nomeada do instalador.
Propriedade (objeto Session)
Leitura/gravação
Recupera as propriedades do produto do banco de dados do produto.
SourcePath
Fornece o caminho completo para a pasta designada na mídia de origem ou na imagem do servidor.
TargetPath
Leitura/gravação
Fornece o caminho completo para a pasta designada na unidade de destino de instalação.
VerifyDiskSpace
Retornará true se houver espaço em disco suficiente e false se o disco estiver cheio.

 

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
IID_ISession é definido como 000C109E-0000-0000-C000-000000000046

Confira também

Exemplos de scripts do Windows Installer