Объект 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 |
|
| IID |
IID_ISession определяется как 000C109E-0000-0000-C000-0000000000046 |
См. также раздел