функция обратного вызова INSTALLUI_HANDLERW (msi.h)
Прототип функции INSTALLUI_HANDLER определяет функцию обратного вызова, которая установщик вызывает уведомления о ходе выполнения и сообщения об ошибках. Дополнительные сведения об использовании этого прототипа функции пример кода доступен в обработке сообщений о ходе выполнения с помощью MsiSetExternalUI.
Синтаксис
INSTALLUI_HANDLERW InstalluiHandlerw;
int InstalluiHandlerw(
LPVOID pvContext,
UINT iMessageType,
LPCWSTR szMessage
)
{...}
Параметры
pvContext
Указатель на контекст приложения, переданный функции MsiSetExternalUI. Этот параметр можно использовать для проверки ошибок.
iMessageType
Задает сочетание одного стиля окна сообщения, одного типа значка сообщения, одной кнопки по умолчанию и одного типа сообщения установки. Этот параметр должен быть одним из следующих.
| Кнопки по умолчанию | Значение |
|---|---|
|
Первая кнопка — это кнопка по умолчанию. |
|
Вторая кнопка — это кнопка по умолчанию. |
|
Третья кнопка — это кнопка по умолчанию. |
| Установка типов сообщенийFlag | Значение |
|---|---|
|
Преждевременное завершение |
|
Отформатированный сообщение об ошибке |
|
Отформатированный предупреждающий сообщение |
|
Сообщение запроса пользователя. |
|
Информативное сообщение для журнала |
|
Список файлов, используемых в настоящее время, которые необходимо закрыть перед заменой. |
|
Запрос на определение допустимого расположения источника |
|
Список файлов, используемых в настоящее время, которые необходимо закрыть перед заменой. Доступно начиная с установщика Windows 4.0. Дополнительные сведения об этом сообщении см. в статье Using Restart Manager with an External UI. |
|
Недостаточно места на диске |
|
Начало сообщения о действии. Это сообщение содержит имя и описание действия. |
|
Форматированные данные, связанные с отдельным элементом действия. |
|
Сведения о датчике хода выполнения. Это сообщение содержит сведения об единицах до сих пор и общем количестве единиц. |
|
Форматированные сведения о диалоговом окне для пользовательского интерфейса. |
|
Отправлено до инициализации пользовательского интерфейса без строковых данных |
|
Отправлено после завершения пользовательского интерфейса без строковых данных |
|
Отправлено перед отображением авторского диалогового окна или мастера |
|
Отправлен до установки продукта. |
|
Отправлено после установки продукта. |
Следующие значения по умолчанию следует использовать, если отсутствуют какие-либо из предыдущих сообщений: MB_OK, значок и MB_DEFBUTTON1. Нет типа сообщения установки по умолчанию; Тип сообщения всегда указывается.
szMessage
Задает текст сообщения.
Возвращаемое значение
Следующие возвращаемые значения сопоставляют кнопки, заданные стилем поля сообщения:
IDOK
Замечания
Дополнительные сведения о возврате значений из внешнего обработчика пользовательского интерфейса см. в разделе Возврат значений из раздела обработчика внешнего пользовательского интерфейса.
Заметка
Заголовок msi.h определяет INSTALLUI_HANDLER как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Установщик 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 |
| целевая платформа | Виндоус |
| заголовка | msi.h |