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