функция обратного вызова INSTALLUI_HANDLERA (msi.h)
Прототип функции INSTALLUI_HANDLER определяет функцию обратного вызова, которую установщик вызывает для уведомления о ходе выполнения и сообщений об ошибках. Дополнительные сведения об использовании этого прототипа функции см. в разделе Обработка сообщений хода выполнения с помощью MsiSetExternalUI.
Синтаксис
INSTALLUI_HANDLERA InstalluiHandlera;
int InstalluiHandlera(
LPVOID pvContext,
UINT iMessageType,
LPCSTR szMessage
)
{...}
Параметры
pvContext
Указатель на контекст приложения, передаваемый в функцию MsiSetExternalUI . Этот параметр можно использовать для проверки ошибок.
iMessageType
Задает сочетание одного стиля окна сообщения, одного типа значка окна сообщения, одной кнопки по умолчанию и одного типа сообщения об установке. Этот параметр должен иметь один из следующих значений.
| Install message TypesFlag | Значение |
|---|---|
|
Преждевременное завершение |
|
Форматированные сообщения об ошибке |
|
Форматируемо предупреждающее сообщение |
|
Сообщение о запросе пользователя. |
|
Информативное сообщение для журнала |
|
Список используемых в настоящее время файлов, которые необходимо закрыть перед заменой. |
|
Запрос на определение допустимого расположения источника |
|
Список используемых в настоящее время файлов, которые необходимо закрыть перед заменой. Доступно начиная с установщика Windows 4.0. Дополнительные сведения об этом сообщении см. в статье Использование диспетчера перезапуска с внешним пользовательским интерфейсом. |
|
Сообщение о нехватке места на диске |
|
Сообщение о начале действия. Это сообщение содержит имя и описание действия. |
|
Форматированные данные, связанные с отдельным элементом действия. |
|
Сведения о датчике хода выполнения. Это сообщение содержит сведения о единицах и общем количестве единиц. |
|
Форматированные сведения о диалоге для пользовательского интерфейса. |
|
Отправлено до инициализации пользовательского интерфейса без строковых данных |
|
Отправлено после завершения пользовательского интерфейса, без строковых данных |
|
Отправлено перед отображением созданных диалоговых окон или мастера |
|
Отправлено до установки продукта. |
|
Отправлено после установки продукта. |
Если какое-либо из предыдущих сообщений отсутствует, следует использовать следующие значения по умолчанию: MB_OK, без значка и MB_DEFBUTTON1. Тип сообщения об установке по умолчанию отсутствует; всегда указывается тип сообщения.
szMessage
Указывает текст сообщения.
Возвращаемое значение
Следующие возвращаемые значения соответствуют кнопкам, указанным в стиле окна сообщения:
IDOK
Комментарии
Дополнительные сведения о возврате значений из внешнего обработчика пользовательского интерфейса см. в разделе Возвращение значений из обработчика внешнего пользовательского интерфейса .
Примечание
Заголовок msi.h определяет INSTALLUI_HANDLER в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Установщик 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 |
| Целевая платформа | Windows |
| Header | msi.h |