Объект Session (установщик Windows)

Объект Session управляет процессом установки. Откроется база данных установщика, содержащая таблицы и данные установки. Этот объект связан со стандартным набором функций действий, каждая из которых выполняет определенные операции с данными из одной или нескольких таблиц. Для конкретных установок продукта можно добавить дополнительные настраиваемые действия. Базовая функция подсистемы — это секвенсор, который извлекает последовательные записи из назначенной таблицы последовательностей, вычисляет любое указанное выражение условия и выполняет назначенное действие. Действия, не распознаваемые подсистемой, откладываются в объект обработчика пользовательского интерфейса для обработки, как правило, последовательностей диалоговых окон.

Обратите внимание, что одним процессом может быть открыт только один объект Session .

Элементы

Объект Session имеет следующие типы элементов:

Методы

Объект Session содержит следующие методы.

Метод Описание
DoAction Выполняет указанное действие.
EvaluateCondition Вычисляет логическое выражение, содержащее символы и значения, и возвращает целое число перечисления msiEvaluateConditionErrorEnum.
FeatureInfo Возвращает объект FeatureInfo , содержащий описательные сведения для указанного компонента.
FormatRecord Возвращает форматированную строку из данных шаблона и записи.
Сообщение Выполняет все включенные операции ведения журнала и откладывает выполнение объекта обработчика пользовательского интерфейса, связанного с подсистемой.
Последовательности Открывает запрос к указанной таблице, упорядочив действия по числам в столбце Последовательности. Для каждой извлекаемой строки вызывается метод DoAction при условии, что любое предоставленное выражение условия не имеет значения False.
SetInstallLevel Устанавливает для текущей установки указанное значение уровня установки и пересчитывает состояния Select и Installed для всех компонентов.

 

Свойства

Объект Session имеет следующие свойства.

Свойство Тип доступа Описание
ComponentCosts
Возвращает объект RecordList , перечисляющий место на диске, необходимое для установки компонента.
ComponentCurrentState
Возвращает текущее установленное состояние назначенного компонента.
ComponentRequestState
Получает или запрашивает изменение состояния действия строки в таблице Компонент.
База данных
Возвращает базу данных для текущего сеанса установки.
FeatureCost
Возвращает общий объем дискового пространства (в единицах 512 байт), необходимого для указанного компонента и его родительских компонентов (вплоть до корня таблицы признаков).
FeatureCurrentState
Возвращает текущее установленное состояние указанного компонента.
FeatureRequestState
Чтение/запись
Получает или запрашивает изменение состояния Выбора записи и вложенных записей компонента.
FeatureValidStates
Возвращает целое число, представляющее битовые флаги, каждый соответствующий бит, представляющий допустимое состояние установки для указанного компонента.
Установщик
Возвращает активный объект установщика.
Язык (объект Session)
Представляет идентификатор числового языка, используемый текущим сеансом установки.
Режим
Это свойство представляет собой значение, представляющее назначенный флаг режима для текущего сеанса установки.
ProductProperty
Представляет строковое значение именованного свойства установщика.
Свойство (объект Session)
Чтение/запись
Извлекает свойства продукта из базы данных продукта.
SourcePath
Предоставляет полный путь к назначенной папке на исходном носителе или образе сервера.
TargetPath
Чтение/запись
Предоставляет полный путь к назначенной папке на целевом диске установки.
VerifyDiskSpace
Возвращает значение true, если на диске достаточно места, и значение false, если диск заполнен.

 

Требования

Требование Значение
Версия
Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или Установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
DLL
Msi.dll
IID
IID_ISession определяется как 000C109E-0000-0000-C000-0000000000046

См. также раздел

Примеры сценариев установщика Windows