Функция MsiSetInternalUI (msi.h)

  • Статья

Функция MsiSetInternalUI включает внутренний пользовательский интерфейс установщика. Затем этот пользовательский интерфейс используется для всех последующих вызовов функций установщика, создающих пользовательский интерфейс, в этом процессе. Дополнительные сведения см. в разделе Уровни пользовательского интерфейса.

Синтаксис

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

Параметры

[in] dwUILevel

Указывает уровень сложности пользовательского интерфейса. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
INSTALLUILEVEL_FULL
 Создан пользовательский интерфейс с мастерами, ходом выполнения и ошибками.
INSTALLUILEVEL_REDUCED
 Пользовательский интерфейс, созданный с отключенными диалоговым окном мастера.
INSTALLUILEVEL_BASIC
 Простая обработка хода выполнения и ошибок.
INSTALLUILEVEL_DEFAULT
 Установщик выбирает соответствующий уровень пользовательского интерфейса.
INSTALLUILEVEL_NONE
 Полностью автоматическая установка. Это включает в себя подавление запроса на повышение прав, даже если это необходимо. Если вы хотите, чтобы пользователь мог повысить уровень, см. INSTALLUILEVEL_UACONLY .
INSTALLUILEVEL_ENDDIALOG
 В сочетании с любым приведенным выше значением установщик отображает модальное диалоговое окно в конце успешной установки или в случае ошибки. Если пользователь отменяет отмену, диалоговое окно не отображается.
INSTALLUILEVEL_PROGRESSONLY
 В сочетании со значением INSTALLUILEVEL_BASIC установщик отображает простые диалоговые окна хода выполнения, но не отображает модальные диалоговые окна или диалоговые окна ошибок.
INSTALLUILEVEL_NOCHANGE
 Уровень пользовательского интерфейса не изменяется. Однако если phWnd не равно Null, родительское окно может измениться.
INSTALLUILEVEL_HIDECANCEL
 В сочетании со значением INSTALLUILEVEL_BASIC установщик отображает простые диалоговые окна хода выполнения, но не отображает кнопку Отмена в диалоговом окне. Это не позволит пользователям отменить установку.
INSTALLUILEVEL_SOURCERESONLY
 Если это значение объединяется со значением INSTALLUILEVEL_NONE , установщик отображает только диалоговые окна, используемые для разрешения исходного кода. Другие диалоговые окна не отображаются. Это значение не действует, если уровень пользовательского интерфейса не INSTALLUILEVEL_NONE. Он используется с внешним пользовательским интерфейсом, предназначенным для обработки всего пользовательского интерфейса, за исключением исходного разрешения. В этом случае установщик обрабатывает разрешение исходного кода.
INSTALLUILEVEL_UACONLY
 В сочетании со значением INSTALLUILEVEL_NONE установка будет полностью безмолвной, за исключением запроса на повышение прав, если это необходимо.

[in, out] phWnd

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

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

Возвращается предыдущий уровень пользовательского интерфейса. Если передается недопустимый dwUILevel , возвращается INSTALLUILEVEL_NOCHANGE .

Комментарии

Функция MsiSetInternalUI полезна, когда установщик должен отображать пользовательский интерфейс. Например, если компонент установлен, но источником является компакт-диск, который необходимо вставить, установщик запрашивает у пользователя компакт-диск. В зависимости от характера установки приложение также может отображать индикаторы хода выполнения или запрашивать у пользователя информацию.

При загрузке Msi.dll для уровня пользовательского интерфейса устанавливается значение DEFAULT, а для владельца пользовательского интерфейса — значение 0 (то есть начальным владельцем пользовательского интерфейса является рабочий стол).

Требования

   
Минимальная версия клиента Установщик 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, см. в разделе Требования к установщику Windows Run-Time.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

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

Интерфейс и функции ведения журнала