Objeto Session (Windows Installer)

Artículo
06/12/2023

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
Propiedades

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	Msi.dll
IID	IID_ISession se define como 000C109E-0000-0000-C000-000000000046

Consulte también

Ejemplos de scripting de Windows Installer