Объект 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 |