Objeto Session (Windows Installer)
El objeto Session controla el proceso de instalación. Abre la base de datos del instalador, que contiene los datos y las tablas de instalación. Este objeto está asociado a un conjunto estándar de funciones de acción, cada una de las cuales realiza operaciones concretas en los datos de una o varias tablas. Se pueden agregar más acciones personalizadas relativas a instalaciones de productos concretas. La función de motor básica es un secuenciador que captura los registros secuenciales de una tabla de secuencia designada, evalúa cualquier expresión de condición especificada y ejecuta la acción designada. Las acciones no reconocidas por el motor se aplazan al objeto de controlador de interfaz de usuario para su procesamiento, normalmente en secuencias de cuadros de diálogo.
Cabe decir que en un mismo proceso solamente se puede abrir un único objeto Session.
Miembros
El objeto Session contiene estos tipos de miembros:
Métodos
El objeto Session tiene estos métodos.
| Método | Descripción |
|---|---|
| DoAction | Ejecuta la acción especificada. |
| EvaluateCondition | Evalúa una expresión lógica que contiene símbolos y valores y devuelve un entero de la enumeración msiEvaluateConditionErrorEnum. |
| FeatureInfo | Devuelve un objeto FeatureInfo que contiene información descriptiva de la característica especificada. |
| FormatRecord | Devuelve una cadena con formato a partir de los datos de registro y plantilla. |
| Message | Realiza las operaciones de registro que haya habilitadas y aplaza la ejecución al objeto de controlador de interfaz de usuario asociado al motor. |
| Sequence | Abre una consulta relativa a la tabla especificada, y ordena las acciones por los números de la columna Sequence. En cada fila obtenida, se llama al método DoAction, siempre y cuando ninguna expresión de condición proporcionada se evalúe como False. |
| SetInstallLevel | Establece el nivel de instalación de la instalación actual en un valor especificado y vuelve a calcular los estados Seleccionar e Instalada de todas las características. |
Propiedades
El objeto Session tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
|
ComponentCosts |
Devuelve un objeto RecordList que enumera el espacio en disco por unidad necesario para instalar un componente. |
|
|
ComponentCurrentState |
Devuelve el estado instalado actual del componente designado. |
|
|
ComponentRequestState |
Obtiene o solicita un cambio del estado Acción de una fila de la tabla Component. |
|
|
Base de datos |
Devuelve la base de datos de la sesión de instalación actual. |
|
|
FeatureCost |
Devuelve la cantidad total de espacio en disco (en unidades de 512 bytes) que necesitan la característica especificada y sus características primarias (hasta la raíz de la tabla Feature). |
|
|
FeatureCurrentState |
Devuelve el estado instalado actual de la característica designada. |
|
|
FeatureRequestState |
Lectura/escritura |
Obtiene o solicita un cambio del estado Seleccionar del registro y subregistros de una característica. |
|
FeatureValidStates |
Devuelve un entero que representa marcas de bits, donde cada bit relevante representa un estado de instalación válido de la característica especificada. |
|
|
Instalador |
Devuelve el objeto de instalador activo. |
|
|
Language (objeto Session) |
Representa el identificador numérico del idioma usado por la sesión de instalación actual. |
|
|
Modo |
Esta propiedad es un valor que representa la marca de modo designada de la sesión de instalación actual. |
|
|
ProductProperty |
Representa el valor de cadena de una propiedad del instalador con nombre. |
|
|
Property (objeto Session) |
Lectura/escritura |
Recupera las propiedades de producto de la base de datos de productos. |
|
SourcePath |
Proporciona la ruta de acceso completa a la carpeta designada en el medio de origen o la imagen de servidor. |
|
|
TargetPath |
Lectura/escritura |
Proporciona la ruta de acceso completa a la carpeta designada en la unidad de destino de la instalación. |
|
VerifyDiskSpace |
Devuelve TRUE si existe suficiente espacio en disco y FALSE si el disco está lleno. |
Requisitos
| Requisito | Value |
|---|---|
| Versión |
Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP |
| Archivo DLL |
|
| IID |
IID_ISession se define como 000C109E-0000-0000-C000-000000000046 |
Consulte también