функция обратного вызова INSTALLUI_HANDLER_RECORD (msi.h)
Прототип функции INSTALLUI_HANDLER_RECORD определяет функцию обратного вызова, которую установщик вызывает для уведомления о ходе выполнения и сообщений об ошибках. Вызовите функцию MsiSetExternalUIRecord , чтобы включить обработчик внешнего пользовательского интерфейса (UI) на основе записей.
Установщик Windows 3.0 и установщик Windows 2.0: Не поддерживается. Доступно начиная с установщика Windows версии 3.1 и более поздних версий.
Синтаксис
INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;
int InstalluiHandlerRecord(
LPVOID pvContext,
UINT iMessageType,
MSIHANDLE hRecord
)
{...}
Параметры
pvContext
Указатель на контекст приложения, переданный в функцию MsiSetExternalUIRecord . Этот параметр можно использовать для проверки ошибок.
iMessageType
Задает сочетание одного стиля окна сообщения, одного типа значка окна сообщения, одной кнопки по умолчанию и одного типа сообщения об установке. Этот параметр должен иметь один из следующих значений.
| Install message TypesFlag | Значение |
|---|---|
|
Преждевременное завершение |
|
Форматированные сообщения об ошибке |
|
Форматируемо предупреждающее сообщение |
|
Сообщение о запросе пользователя. |
|
Информативное сообщение для журнала |
|
Список файлов, используемых в настоящее время, которые необходимо закрыть перед заменой |
|
Запрос на определение допустимого расположения источника |
|
Список используемых в настоящее время файлов, которые необходимо закрыть перед заменой. Доступно начиная с установщика Windows версии 4.0. Дополнительные сведения об этом сообщении см. в статье Использование диспетчера перезапуска с внешним пользовательским интерфейсом. |
|
Сообщение о нехватке места на диске |
|
Сообщение о начале действия. Это сообщение содержит имя и описание действия. |
|
Форматированные данные, связанные с отдельным элементом действия. |
|
Сведения о датчике хода выполнения. Это сообщение содержит сведения о единицах и общем количестве единиц. |
|
Форматированные сведения о диалоге для пользовательского интерфейса. |
|
Отправлено до инициализации пользовательского интерфейса без строковых данных |
|
Отправлено после завершения пользовательского интерфейса, без строковых данных |
|
Отправлено перед отображением созданных диалоговых окон или мастера |
|
Отправлено до установки продукта. |
|
Отправлено после установки продукта. |
Если какое-либо из предыдущих сообщений отсутствует, следует использовать следующие значения по умолчанию: MB_OK, без значка и MB_DEFBUTTON1. Тип сообщения об установке по умолчанию отсутствует; всегда указывается тип сообщения.
hRecord
Задает дескриптор объекта записи. Сведения об объектах записей см. в разделе Функции обработки записей.
Возвращаемое значение
Следующие возвращаемые значения соответствуют кнопкам, указанным в стиле окна сообщения:
IDOK
Комментарии
Этот тип внешнего обработчика пользовательского интерфейса следует использовать, когда известно, какой тип ошибок или сообщений интересует вызывающий объект, и хочет избежать дополнительных затрат на анализ строкового сообщения, которое отправляется внешнему обработчику пользовательского интерфейса INSTALLUI_HANDLER типа, но извлекает интересующие данные из полей hRecord.
Дополнительные сведения о возврате значений из внешнего обработчика пользовательского интерфейса см. в разделе Возвращение значений из обработчика внешнего пользовательского интерфейса . Объект hRecord, отправляемый внешнему обработчику пользовательского интерфейса на основе записей, принадлежит установщику Windows и действителен только в течение времени существования обратного вызова. Обратный вызов должен извлекать из записи все необходимые данные и не закрывать этот дескриптор.
Любая попытка внешнего обработчика пользовательского интерфейса на основе записей изменить данные в объекте hRecord будет игнорироваться установщиком Windows.
Дополнительные сведения об использовании внешнего обработчика на основе записей см. в разделе Мониторинг установки с помощью MsiSetExternalUIRecord.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Установщик 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 3.1 в Windows Server 2003 или Windows XP. |
| Целевая платформа | Windows |
| Header | msi.h |
См. также раздел
Не поддерживается в установщике Windows 3.0 и более ранних версий