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

Возврат значений из обработчика внешнего пользовательского интерфейса

  • Статья

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

Внешний обработчик пользовательского интерфейса может в любое время возвращать значения –1 и 0, так как они не связаны с типами кнопок. Возвращаемое значение –1 указывает на то, что во внешнем обработчике пользовательского интерфейса произошла внутренняя ошибка. Возвращаемое значение 0 указывает, что внешний обработчик пользовательского интерфейса не обработал сообщение установщика, и вместо этого установщик должен обработать сообщение.

Для сообщений, которые не содержат тип кнопки, например INSTALLMESSAGE_ACTIONDATA и INSTALLMESSAGE_PROGRESS, при возврате IDCANCEL установка будет отменена. Возврат IDOK уведомляет установщик о том, что сообщение было обработано внешним обработчиком пользовательского интерфейса.

Остальные возвращаемые значения, как описано ниже, напрямую связаны с типами кнопок, включенными в тип сообщения.

Возвращаемое значение внешнего пользовательского интерфейса Значение
IDOK Пользователь нажал кнопку ОК . Информация о сообщении была понята.
IDCANCEL Нажата кнопка ОТМЕНА . Отмените установку.
IDABORT Нажата кнопка ABORT . Прервите установку.
IDRETRY Нажата кнопка RETRY . Повторите действие.
IDIGNORE Нажата кнопка IGNORE . Пропустить ошибку и продолжить.
IDYES Нажата кнопка ДА . Утвердительный ответ, продолжайте с текущей последовательностью событий.
IDNO Нажата кнопка НЕТ . Отрицательный ответ не следует продолжать с текущей последовательностью событий.

 

Например, если внешнему обработчику пользовательского интерфейса отправляется сообщение с флагом стилей окна сообщения MB_ABORTRETRYIGNORE, внешний обработчик пользовательского интерфейса может вернуть одно из следующих значений:

  • –1 (ошибка во внешнем обработчике пользовательского интерфейса)
  • 0 (во внешнем обработчике пользовательского интерфейса не выполняется никаких действий, разрешите установщику Windows обработать его)
  • IDABORT (нажата кнопка ABORT )
  • IDRETRY (нажата кнопка RETRY )
  • IDIGNORE (кнопка IGNORE нажата)