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

Таблица MsiEmbeddedUI

  • Статья

Таблица MsiEmbeddedUI определяет пользовательский интерфейс, внедренный в пакет установщика Windows.

установщике Windows 4.0 или более ранней версии: не поддерживается. Эта таблица доступна начиная с установщика Windows 4.5.

Таблица MsiEmbeddedUI содержит следующие столбцы.

Столбец Тип Ключ Допустимое значение NULL
MsiEmbeddedUI идентификатора Y N
Имя файла текста N N
Атрибуты целочисленного N N
MessageFilter DoubleInteger N Y
Данные двоичного N N

 

Столбцы

MsiEmbeddedUI

Первичный ключ для таблицы.

имя файла

Имя файла, который получает двоичные сведения в столбце данных. Имя файла требуется для включения расширения. Например, имя embeddedui.dll допустимо, но embeddedui неприемлемо. Имя может быть локализовано. Это поле может содержать короткое имя файла или длинное имя файла, но оно не может содержать оба. Формат этого поля похож на тип данных столбца имя файла, за исключением того, что разделитель вертикальной полосы (|) для синтаксиса имени короткого файла или имени длинного файла недоступен. Так как некоторые веб-серверы могут быть конфиденциальными, FileName должен соответствовать регистру исходных файлов, чтобы обеспечить поддержку загрузки в Интернет.

атрибуты

Сведения о данных в столбце данных. Значение в этом поле может содержать одну или несколько следующих констант.

Постоянный Шестнадцатиричный Десятичный Значение
Никакой 0x00 0 Файл не является DLL-файлом пользовательского интерфейса. Это может быть файл ресурсов, используемый пользовательским интерфейсом.
msidbEmbedededUI 0x01 1 Основной DLL-файл пользовательского интерфейса. С помощью этого атрибута можно пометить не более одной строки в таблице. Если для этого атрибута отмечено несколько строк, это ошибка, и она не может быть гарантирована, какую библиотеку DLL используется.
msidbEmbedHandlesBasic 0x02 2 Позволяет установщику вызывать внедренный пользовательский интерфейс во время базовой установки уровня пользовательского интерфейса. Установщик игнорирует этот атрибут, если он не сочетается с атрибутом msidbEmbeddedUI.

 

MessageFilter

Указывает типы сообщений, отправляемых в библиотеку DLL пользовательского интерфейса. Этот столбец относится только к строкам с атрибутом msidbEmbeddedUI. Это поле должно иметь значение NULL, если строка ссылается на файл ресурсов, а значение Атрибутов равно NULL. Если строка ссылается на библиотеку DLL пользовательского интерфейса, значение в этом столбце не должно быть null.

Значение в этом столбце может быть сочетанием следующих значений. Установщик игнорирует любые другие значения.

Постоянный Шестнадцатиричный Десятичный Описание
INSTALLLOGMODE_FATALEXIT 0x00001 1 Преждевременное завершение.
INSTALLLOGMODE_ERROR 0x00002 2 Сообщения об ошибках.
INSTALLLOGMODE_WARNING 0x00004 4 Предупреждения.
INSTALLLOGMODE_USER 0x00008 8 Сообщения пользователей.
INSTALLLOGMODE_INFO 0x00010 16 Незалогированные сообщения о состоянии.
INSTALLLOGMODE_FILESINUSE 0x00020 32 Файлы, используемые в настоящее время.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 Запросы на разрешение источников.
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 Сообщения места на диске.
INSTALLLOGMODE_ACTIONSTART 0x00100 256 Действия запуска сообщений.
INSTALLLOGMODE_ACTIONDATA 0x00200 512 Сообщения данных действия.
INSTALLLOGMODE_PROGRESS 0x00400 1024 Сообщения о ходе выполнения.
INSTALLLOGMODE_COMMONDATA 0x00800 2048 Сообщения инициализации пользовательского интерфейса.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Сообщения о запуске пользовательского интерфейса, отправленные при запуске установки продукта.
INSTALLLOGMODE_TERMINATE 0x02000 8192 Сообщения о завершении работы пользовательского интерфейса, отправленные после завершения установки продукта.
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 Сообщения, отправленные до отображения диалогового окна пользовательского интерфейса.
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 Файлы, используемые в настоящее время.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 Начинается установка продукта. Сообщение содержит имя продукта и ProductCode.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 Установка продукта заканчивается. Сообщение содержит значение ProductName, ProductCode и возвращаемое значение продукта.

 

данные

Этот столбец содержит двоичные сведения. Если поле атрибута отмечено атрибутом msidbEmbeddedUI атрибутом, сведения в этом поле должны быть библиотекой DLL. Если поле "Атрибут" не является атрибутом msidbEmbeddedUI, сведения в этом поле могут быть файлом ресурсов в любом формате.

Замечания

Чтобы использовать внедренный пользовательский интерфейс, разработчик установки должен создать эту функцию в пакет установщика Windows. Таблица MsiEmbeddedUI определяет внедренный пользовательский интерфейс. Библиотека DLL для встроенного пользовательского интерфейса должна экспортировать функции InitializeEmbeddedUI, EmbeddedUIHandlerи ShutdownEmbeddedUI. Пакеты, не поддерживающие внедренный пользовательский интерфейс, могут использовать внутренний пользовательский интерфейс установщика Windows.

Чтобы запустить средства отладки для Windows в внедренном пользовательском интерфейсе, используйте методы, описанные в отладке пользовательских действий. Задайте значение MsiBreak в MsiEmbeddedUI.

Пример встроенного пользовательского пользовательского интерфейса см. в статье Использование внедренного пользовательского интерфейса.