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

Возвращение сообщений об ошибках из пользовательских действий

  • Статья

В этом разделе описывается, как отправлять сообщения из пользовательских действий, которые фактически выполняют часть установки, вызывая динамическую библиотеку или скрипт. Обратите внимание, что тип пользовательского действия 19 отправляет только указанное сообщение об ошибке, возвращает ошибку и завершает установку. Тип пользовательского действия 19 не выполняет какую-либо часть установки.

Чтобы отправить сообщение об ошибке из пользовательского действия, использующего библиотеку динамической компоновки (DLL), вызов пользовательского действия MsiProcessMessage. Обратите внимание, что пользовательские действия, запускаемые DoAction ControlEvent, могут отправлять сообщения методомMessage, но не могут отправлять сообщение с помощью MsiProcessMessage. В системах, предшествующих Windows Server 2003, пользовательские действия, запущенные DoAction ControlEvent, не могут отправлять сообщения с помощью метода MsiProcessMessage или Message. Дополнительные сведения см. в разделе Отправка сообщений Установщику Windows с использованием msiProcessMessage.

Отображение сообщения об ошибке в пользовательском действии с помощью библиотеки DLL

  1. Настраиваемое действие должно вызывать MsiProcessMessage и передавать параметры hInstall, eMessageTypeи hRecord. Дескриптор установки, тип пользовательского действия 19, может быть предоставлен пользовательскому действию, как описано в доступе к текущему сеансу установщика изнутри пользовательского действия или из MsiOpenProduct или MsiOpenPackage.
  2. Параметр eMessageType должен указать один из типов сообщений, указанных в MsiProcessMessage.
  3. Параметр hRecord функции MsiProcessMessage зависит от типа сообщения. См. Отправка сообщений программе установки Windows с помощью MsiProcessMessage. Если сообщение содержит отформатированные данные, введите сообщение в таблицу Ошибка, используя форматирование, описанное в Форматирование.

Чтобы отправить сообщение об ошибке из пользовательского действия, использующего скрипты, пользовательское действие может вызвать метод Message объекта Session.

Отображение сообщения об ошибке в пользовательском действии с помощью скрипта

  1. Настраиваемое действие должно вызывать метод Message объекта Session и передавать параметры тип и запись.
  2. Параметр типа должен указать один из типов сообщений, перечисленных в методе Message.
  3. Параметр записи метода Message зависит от типа Message. Если сообщение содержит отформатированные данные, введите сообщение в таблицу Error, используя форматирование, описанное в Formatted.

Пользовательские действия, использующие [исполняемые файлы], не могут отправлять сообщение путем вызова [MsiProcessMessage] или метода [Message] так как они не могут получить идентификатор установки.

возвращаемые значения пользовательских операций