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

Статья
11/20/2024

Функция MsiInstallMissingComponent устанавливает файлы, которые неожиданно отсутствуют.

Синтаксис

UINT MsiInstallMissingComponentA(
  [in] LPCSTR       szProduct,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE eInstallState
);

Параметры

[in] szProduct

Указывает код продукта для продукта, которому принадлежит компонент, который должен быть установлен.

[in] szComponent

Определяет установленный компонент.

[in] eInstallState

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

Ценность	Значение
INSTALLSTATE_LOCAL	Компонент должен быть установлен локально.
INSTALLSTATE_SOURCE	Компонент должен быть установлен для запуска из источника.
INSTALLSTATE_DEFAULT	Компонент должен быть установлен в соответствии со значениями по умолчанию установщика.

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

Ценность	Значение
ERROR_BAD_CONFIGURATION	Сведения о конфигурации повреждены.
ERROR_INSTALL_FAILURE	Сбой установки.
ERROR_INSTALL_SOURCE_ABSENT	Источник недоступен.
ERROR_INSTALL_SUSPEND	Установка была приостановлена.
ERROR_INSTALL_USEREXIT	Пользователь завершил установку.
ERROR_INVALID_PARAMETER	Один из параметров недопустим.
ERROR_SUCCESS	Функция успешно завершена.
ERROR_UNKNOWN_PRODUCT	Код продукта не распознается.

Дополнительные сведения об сообщениях об ошибках см. в отображаемых сообщений об ошибках

Замечания

Функция MsiInstallMissingComponent разрешает компоненты, к которым принадлежит компонент. Затем устанавливается компонент продукта, требующий минимального дополнительного места на диске.

Заметка

Заголовок msi.h определяет MsiInstallMissingComponent как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Установщик 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 Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, требуемом версией установщика Windows, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

Multiple-Package установки

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