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


функция обратного вызова INSTALLUI_HANDLERA (msi.h)

Прототип функции INSTALLUI_HANDLER определяет функцию обратного вызова, которую установщик вызывает для уведомления о ходе выполнения и сообщений об ошибках. Дополнительные сведения об использовании этого прототипа функции см. в разделе Обработка сообщений хода выполнения с помощью MsiSetExternalUI.

Синтаксис

INSTALLUI_HANDLERA InstalluiHandlera;

int InstalluiHandlera(
  LPVOID pvContext,
  UINT iMessageType,
  LPCSTR szMessage
)
{...}

Параметры

pvContext

Указатель на контекст приложения, передаваемый в функцию MsiSetExternalUI . Этот параметр можно использовать для проверки ошибок.

iMessageType

Задает сочетание одного стиля окна сообщения, одного типа значка окна сообщения, одной кнопки по умолчанию и одного типа сообщения об установке. Этот параметр должен иметь один из следующих значений.

Стили окна сообщенияFlag Значение
MB_ABORTRETRYIGNORE
Окно сообщения содержит кнопки "Прервать", "Повторить" и "Пропустить ".
MB_OK
Окно сообщения содержит кнопку ОК . Это значение по умолчанию.
MB_OKCANCEL
Окно сообщения содержит кнопки ОК и Отмена .
MB_RETRYCANCEL
Окно сообщения содержит кнопки Повторить и Отмена .
MB_YESNO
Окно сообщения содержит кнопки Да и Нет .
MB_YESNOCANCEL
Окно сообщения содержит кнопки Да, Нет и Отмена .
 
Значок окна сообщенияTypesFlag Значение
MB_ICONEXCLAMATION, MB_ICONWARNING
В окне сообщения появится восклицательный знак.
MB_ICONINFORMATION, MB_ICONASTERISK
В окне сообщения появится информационный знак.
MB_ICONQUESTION
В окне сообщения появится вопросительный знак.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
В окне сообщения появится знак остановки.
 
Кнопка по умолчаниюFlag Значение
MB_DEFBUTTON1
Первая кнопка является кнопкой по умолчанию.
MB_DEFBUTTON2
Вторая кнопка является кнопкой по умолчанию.
MB_DEFBUTTON3
Третья кнопка является кнопкой по умолчанию.
 
Install message TypesFlag Значение
INSTALLMESSAGE_FATALEXIT
Преждевременное завершение
INSTALLMESSAGE_ERROR
Форматированные сообщения об ошибке
INSTALLMESSAGE_WARNING
Форматируемо предупреждающее сообщение
INSTALLMESSAGE_USER
Сообщение о запросе пользователя.
INSTALLMESSAGE_INFO
Информативное сообщение для журнала
INSTALLMESSAGE_FILESINUSE
Список используемых в настоящее время файлов, которые необходимо закрыть перед заменой.
INSTALLMESSAGE_RESOLVESOURCE
Запрос на определение допустимого расположения источника
INSTALLMESSAGE_RMFILESINUSE
Список используемых в настоящее время файлов, которые необходимо закрыть перед заменой. Доступно начиная с установщика Windows 4.0. Дополнительные сведения об этом сообщении см. в статье Использование диспетчера перезапуска с внешним пользовательским интерфейсом.
INSTALLMESSAGE_OUTOFDISKSPACE
Сообщение о нехватке места на диске
INSTALLMESSAGE_ACTIONSTART
Сообщение о начале действия. Это сообщение содержит имя и описание действия.
INSTALLMESSAGE_ACTIONDATA
Форматированные данные, связанные с отдельным элементом действия.
INSTALLMESSAGE_PROGRESS
Сведения о датчике хода выполнения. Это сообщение содержит сведения о единицах и общем количестве единиц.
INSTALLMESSAGE_COMMONDATA
Форматированные сведения о диалоге для пользовательского интерфейса.
INSTALLMESSAGE_INITIALIZE
Отправлено до инициализации пользовательского интерфейса без строковых данных
INSTALLMESSAGE_TERMINATE
Отправлено после завершения пользовательского интерфейса, без строковых данных
INSTALLMESSAGE_SHOWDIALOG
Отправлено перед отображением созданных диалоговых окон или мастера
INSTALLMESSAGE_INSTALLSTART
Отправлено до установки продукта.
INSTALLMESSAGE_INSTALLEND
Отправлено после установки продукта.
 
 

Если какое-либо из предыдущих сообщений отсутствует, следует использовать следующие значения по умолчанию: MB_OK, без значка и MB_DEFBUTTON1. Тип сообщения об установке по умолчанию отсутствует; всегда указывается тип сообщения.

szMessage

Указывает текст сообщения.

Возвращаемое значение

Следующие возвращаемые значения соответствуют кнопкам, указанным в стиле окна сообщения:

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Комментарии

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

Примечание

Заголовок 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

См. также раздел

MsiSetExternalUI