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

  • Статья

Функция MsiInstallProduct устанавливает или удаляет продукт.

Синтаксис

UINT MsiInstallProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szCommandLine
);

Параметры

[in] szPackagePath

Строка со значением NULL, указывающая путь к расположению пакета установщика Windows. Строковое значение может содержать URL-адрес (например http://packageLocation/package/package.msi, ), сетевой путь (например, \packageLocation\package.msi), путь к файлу (например, file://packageLocation/package.msi) или локальный путь (например, D:\packageLocation\package.msi).

[in] szCommandLine

Строка, завершающаяся значением NULL, указывающая параметры свойства командной строки. Это должен быть список формата Property=Setting Property=Setting. Дополнительные сведения см. в разделе Сведения о свойствах.

Чтобы выполнить административную установку, включите ACTION=ADMIN в szCommandLine. Дополнительные сведения см. в свойстве ACTION .

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

Значение Значение
ERROR_SUCCESS
 Функция успешно завершается.
Ошибка, связанная с действием
 Дополнительные сведения см. в разделе Коды ошибок.
Ошибка инициализации
 Произошла ошибка, связанная с инициализацией.
 

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

Комментарии

Функция MsiInstallProduct отображает пользовательский интерфейс с текущими параметрами и режимом журнала.

  • Параметры пользовательского интерфейса можно изменить с помощью функций MsiSetInternalUI, MsiSetExternalUI или MsiSetExternalUIRecord .
  • Режим журнала можно задать с помощью функции MsiEnableLog .
  • Вы можете полностью удалить продукт, установив параметр REMOVE=ALL в szCommandLine.
Дополнительные сведения см. в разделе REMOVE Property.

Примечание

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

Требования

   
Минимальная версия клиента Установщик 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

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

Отображаемые сообщения об ошибках

Код ошибки

Ошибка инициализации

Функции установки и конфигурации

Установка с несколькими пакетами