Поделиться через


Функция MsiGetMode (msiquery.h)

Функция MsiGetMode используется для определения того, работает ли установщик в данный момент в указанном режиме, как указано в таблице . Функция возвращает логическое значение TRUE или FALSE, указывающее, задано ли определенное свойство, переданное в функцию, в данный момент задано (TRUE) или не задано (FALSE).

Синтаксис

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

Параметры

[in] hInstall

Дескриптор установки, предоставленной пользовательскому действию DLL или полученной через MsiOpenPackage, MsiOpenPackageEx или MsiOpenProduct.

[in] eRunMode

Указывает режим выполнения. Этот параметр должен иметь одно из следующих значений.

Значение Значение
MSIRUNMODE_ADMIN
Выполняется установка в административном режиме или установка продукта.
MSIRUNMODE_ADVERTISE
Объявления устанавливаются или продукт устанавливается или обновляется.
MSIRUNMODE_MAINTENANCE
Существующая установка изменяется или имеется новая установка.
MSIRUNMODE_ROLLBACKENABLED
Откат включен.
MSIRUNMODE_LOGENABLED
Файл журнала активен. Она была включена до сеанса установки.
MSIRUNMODE_OPERATIONS
Операции выполнения находятся на этапе определения.
MSIRUNMODE_REBOOTATEND
Перезагрузка необходима после успешной установки (settable).
MSIRUNMODE_REBOOTNOW
Для продолжения установки (settable) необходима перезагрузка.
MSIRUNMODE_CABINET
Устанавливаются файлы из шкафов и файлы таблиц мультимедиа .
MSIRUNMODE_SOURCESHORTNAMES
Исходный объект LongFileNames подавляется с помощью свойства сводки PID_MSISOURCE.
MSIRUNMODE_TARGETSHORTNAMES
Целевой объект LongFileNames подавляется с помощью свойства SHORTFILENAMES .
MSIRUNMODE_RESERVED11
Зарезервировано для последующего использования.
MSIRUNMODE_WINDOWS9X
Операционная система имеет 9-кратную версию.
MSIRUNMODE_ZAWENABLED
Операционная система поддерживает установку по требованию.
MSIRUNMODE_RESERVED14
Зарезервировано для последующего использования.
MSIRUNMODE_RESERVED15
Зарезервировано для последующего использования.
MSIRUNMODE_SCHEDULED
Настраиваемое действие, вызываемое при выполнении скрипта установки.
MSIRUNMODE_ROLLBACK
Настраиваемое действие, вызываемое из скрипта отката.
MSIRUNMODE_COMMIT
Настраиваемое действие, вызываемое из скрипта выполнения фиксации.

Возвращаемое значение

Значение TRUE указывает, что определенное свойство, переданное в функцию, задано в данный момент.

Значение FALSE указывает, что определенное свойство, переданное в функцию, в настоящее время не задано.

Комментарии

Обратите внимание, что не все значения режима выполнения iRunMode доступны при вызове MsiGetMode из отложенного настраиваемого действия. Дополнительные сведения см. в разделе Получение сведений о контексте для пользовательских действий отложенного выполнения.

Требования

   
Минимальная версия клиента Установщик 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
Целевая платформа Windows
Header msiquery.h
Библиотека Msi.lib
DLL Msi.dll

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

Функции доступа к состоянию установщика