Отправка сообщений в установщик 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	Шаблон для форматирования результирующей строки. Дополнительные сведения см. в разделе MsiFormatRecord . На поля записи ссылаются с помощью [1] для поля 1, [2] для поля 2 и т. д.
От 1 до n	Все последующие поля напрямую связаны с полями, на которые ссылается шаблон в поле 0.

 

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

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

INSTALLMESSAGE_ERROR

 

INSTALLMESSAGE_WARNING

 

INSTALLMESSAGE_USER

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

Поле	Описание
0	Должно иметь значение NULL.
1	Номер сообщения в таблице Error.
От 2 до n	Относится к указанному сообщению в таблице Error.

 

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

Поле	Тип	Данные
0	строка	null
1	INT	1304
2	строка	Myfile.txt

 

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

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

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

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

INSTALLMESSAGE_COMMONDATA

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

Поле	Описание
0	Не используется.
1	2 относится к кнопке Отмена .
2	Значение 1 указывает, что должна отображаться кнопка Отмена . Значение 0 указывает, что кнопка Отмена должна быть невидимой.

 

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

Поле	Тип	Данные
0	строка	null
1	INT	2
2	INT	0

 

INSTALLMESSAGE_ACTIONSTART

 

INSTALLMESSAGE_ACTIONDATA

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

Поле	Описание
0	null
1	Имя действия. Имя в этом поле должно быть не равно NULL.
2	Описание действия.
3	Шаблон действия. Используется для ActionData, сообщение которого форматируется в соответствии с этим шаблоном.

 

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

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

Поле	Описание
0	null
От 1 до n	Зависит от поля 3 соответствующего INSTALLMESSAGE_ACTIONSTART сообщения или шаблона, указанного в таблице ActionText.

 

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

Поле	Тип	Данные
0	строка	null
1	строка	MyAction
2	строка	Это описание "MyAction"
3	строка	Шаблон MyAction: данные field1 — [1]. Данные поля 2 — [2].

 

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

запись INSTALLMESSAGE_ACTIONDATA.

Поле	Тип	Данные
0	строка	null
1	INT	2
2	строка	ActionData для MyAction

 

INSTALLMESSAGE_FILESINUSE

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

Поле	Описание
0	Это поле может иметь значение NULL. Для установки с использованием базового пользовательского интерфейса в этом поле может быть указан статический текст для отображения в элементе управления ListBoxдиалогового окна FilesInUse. Для установки с использованием полного пользовательского интерфейса это поле не оказывает влияния, так как текст задается при создании настраиваемого диалогового окна FilesInUse.
1	Имя используемого файла.
2	Это поле идентифицирует процесс, в котором используется файл. Установщик Windows версии 4.0: Идентификатор процесса (PID) процесса или название окна процесса. Установщик Windows версии 3.1 и более ранних версий: Это поле должно быть идентификатором процесса (PID).

 

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

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

Поле	Описание
0	null
1	Red.exe
2	Заголовок красного окна
3	Blue.exe
4	Заголовок синего окна

 

Примечание

В установщике Windows версии 4.0, если идентификатор PID, переданный из службы, не имеет заголовка окна, например приложения панели задач, файл не отображается, а подробный журнал содержит следующие сообщения.

 

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.

Поле	Описание
0	null
1	null
2	Имя пакета.
3	Код продукта.
4	Относительный путь, если он известен, может иметь значение NULL.
5	0
6	Проверяется ли код пакета. Значение "1" указывает, что код пакета должен быть проверен. Значение "0" указывает, что пакет не должен проверяться.
7	Обязательный диск из таблицы мультимедиа. Значение "0" указывает, что любой диск является допустимым.