Функция MsiEndTransaction (msi.h)

Статья
03/05/2024

Функция MsiEndTransaction может фиксировать или откатывать все установки, принадлежащие транзакции, открытой функцией MsiBeginTransaction . Эта функция должна вызываться текущим владельцем транзакции.

Установщик Windows 4.0 и более ранние версии: Не поддерживается. Эта функция доступна начиная с установщика Windows 4.5.

Синтаксис

UINT MsiEndTransaction(
  [in] DWORD dwTransactionState
);

Параметры

[in] dwTransactionState

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

Значение	Значение
MSITRANSACTIONSTATE_ROLLBACK	Выполняет откат установки , чтобы отменить изменения в системе, принадлежащей транзакции, открытой функцией MsiBeginTransaction .
MSITRANSACTIONSTATE_COMMIT	Фиксирует все изменения в системе, принадлежащей транзакции. Выполняет любые пользовательские действия фиксации и фиксирует в системе любые изменения в сборках Win32 или CLR. Удаляет скрипт отката, и после использования этого параметра изменения транзакции больше не могут быть отменены с помощью отката установки.

Значение

MSITRANSACTIONSTATE_ROLLBACK

Выполняет откат установки , чтобы отменить изменения в системе, принадлежащей транзакции, открытой функцией MsiBeginTransaction .

MSITRANSACTIONSTATE_COMMIT

Фиксирует все изменения в системе, принадлежащей транзакции. Выполняет любые пользовательские действия фиксации и фиксирует в системе любые изменения в сборках Win32 или CLR. Удаляет скрипт отката, и после использования этого параметра изменения транзакции больше не могут быть отменены с помощью отката установки.

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

Функция MsiEndTransaction возвращает следующие значения.

Значение	Значение
ERROR_ACCESS_DENIED	Транзакция может быть завершена только текущим владельцем.
ERROR_INSTALL_FAILURE	Не удалось завершить установку транзакции.
ERROR_INSTALL_ALREADY_RUNNING	Установка, принадлежащая транзакции, продолжается.
ERROR_ROLLBACK_DISABLED	Установка, принадлежащая транзакции, не завершена. Во время установки действие DisableRollback отключает откат установки пакета. Установщик выполняет откат установки до точки, где откат был отключен, и функция возвращает эту ошибку.

Требования

Требование	Значение
Минимальная версия клиента	Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.5 в Windows Vista, Windows XP, Windows Server 2003 и Windows Server 2008. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в разделе Требования к установщику Windows Run-Time.
Целевая платформа	Windows
Header	msi.h
Библиотека	Msi.lib
DLL	Msi.dll

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

Установка нескольких пакетов

Share via