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

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

  • Статья

В этом разделе описывается, как отправлять сообщения из пользовательских действий, которые фактически выполняют часть установки путем вызова библиотеки или скрипта динамической компоновки. Обратите внимание, что тип настраиваемого действия 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. Параметр record метода Message зависит от типа сообщения. Если сообщение содержит отформатированные данные, введите сообщение в таблицу Ошибка , используя форматирование, описанное в разделе Форматированные данные.

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

Возвращаемые значения настраиваемого действия