Отправка сообщений в установщик Windows с помощью MsiProcessMessage

Сообщения, отправляемые с помощью MsiProcessMessage , — это те же сообщения, которые получаются функцией обратного вызова INSTALLUI_HANDLER при вызове MsiSetExternalUI . В противном случае установщик Windows обрабатывает сообщения. Дополнительные сведения см. в разделе Анализ сообщений установщика Windows.

Например, чтобы отправить сообщение INSTALLMESSAGE_ERROR со значком MB_ICONWARNING и кнопками MB_ABORTRETRYCANCEL:

PMSIHANDLE hInstall;
PMSIHANDLE hRec;
MsiProcessMessage(hInstall, INSTALLMESSAGE(INSTALLMESSAGE_ERROR|MB_ABORTRETRYIGNORE|MB_ICONWARNING), hRec);

Где hInstall — это дескриптор установки, предоставленный для пользовательского действия или дескриптора hProduct из MsiOpenProduct или MsiOpenPackage, а hRec — это запись, содержащая сведения об ошибке для форматирования. Сведения о том, как выполняется форматирование, см. в разделе MsiFormatRecord.

По умолчанию, если сообщение INSTALLMESSAGE_ERROR или INSTALLMESSAGE_FATALEXIT отправляется без указания типа кнопки или типа значков, используются MB_OK, без значков и MB_DEFBUTTON1.

Установщик Windows не помечает кнопку ABORT строкой "Abort" при отображении MessageBox со спецификацией кнопки MB_ABORTRETRYIGNORE, а вместо этого помечает кнопку строкой "Отмена". Все сообщения об ошибках не используют слово "Abort" и вместо него используют слово "Отмена".

Параметр hRecord функции MsiProcessMessage зависит от типа сообщения, отправленного в MsiProcessMessage. В следующем списке подробно описаны требования к записи по отношению к типу сообщения:

INSTALLMESSAGE_FATALEXIT

INSTALLMESSAGE_INFO

INSTALLMESSAGE_OUTOFDISKSPACE

Если поле 0 имеет значение NULL, строка, полученная обработчиком пользовательского интерфейса, имеет следующий формат: 1: [данные из поля 1] 2: [данные из поля 2], что означает, что для каждого поля записи строка содержит номер поля, за которым следует данные, хранящиеся в поле.

Информационные сообщения из MsiProcessMessage регистрируются, когда MsiEnableLog, параметр командной строки "/l" или политика ведения журнала указывают "I" или INSTALLLOGMODE_INFO.

INSTALLMESSAGE_ERROR

INSTALLMESSAGE_WARNING

INSTALLMESSAGE_USER

Использование сообщения из таблицы Error.

Например, если выбран диапазон 10.0.0.0/20 для виртуальной сети, для пространства клиентских адресов можно выбрать 10.1.0.0/24.

Итоговое сообщение, полученное от обработчика пользовательского интерфейса:

Ошибка 1304. Ошибка записи в файл: Myfile.txt. Убедитесь, что у вас есть доступ к каталогу.

Если поле 0 не равно NULL, сообщение из таблицы ошибок переопределяется. Вместо этого шаблон поля 0 определяет формат сообщения.

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

INSTALLMESSAGE_COMMONDATA

Это сообщение отправляется для включения или отключения кнопки Отмена в диалоговом окне хода выполнения.

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

INSTALLMESSAGE_ACTIONSTART

INSTALLMESSAGE_ACTIONDATA

Запись INSTALLMESSAGE_ACTIONSTART определяет формат записи ActionData.

Не ссылайтесь на поле 0 в сообщении шаблона действия.

Запись INSTALLMESSAGE_ACTIONDATA форматируется следующим образом.

Например, запись INSTALLMESSAGE_ACTIONSTART.

Шаблон для INSTALLMESSAGE_ACTIONSTART (поле 3) ссылается на поля 1 и 2, запись INSTALLMESSAGE_ACTIONDATA должна содержать 2 поля, содержащие обязательные данные. Поля могут быть строковыми или целыми числами.

запись INSTALLMESSAGE_ACTIONDATA.

INSTALLMESSAGE_FILESINUSE

Запись FILESINUSE является записью переменной длины.

Например, чтобы отправить сообщение FilesInUse с двумя используемыми файлами, red.exe и blue.exe, запись содержит четыре поля плюс поле 0. Формат записи будет таким, как показано в следующей таблице. Для этого примера требуется установщик Windows версии 4.0.

Установщик Windows версии 3.1 и более ранних версий: Поля 2 и 4 в следующем примере должны содержать идентификаторы PID процессов, содержащих red.exe и blue.exe.

File In Use: -<FileName>- Window could not be found. Process ID: <PID>
No window with title could be found for FilesInUse

INSTALLMESSAGE_RESOLVESOURCE

Запись INSTALLMESSAGE_RESOLVESOURCE содержит семь полей. Для правильной работы INSTALLMESSAGE_RESOLVESOURCE внешний обработчик пользовательского интерфейса может не обрабатывать сообщение INSTALLMESSAGE_RESOLVESOURCE. Установщик Windows должен обрабатывать сообщение INSTALLMESSAGE_RESOLVESOURCE. То есть внешний обработчик пользовательского интерфейса возвращает значение 0, указывающее на отсутствие действий при фильтрации INSTALLMESSAGE_RESOLVESOURCE сообщения. Рекомендуется избегать отправки сообщения RESOLVESOURCE.