Функция 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

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

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