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

Статья
11/20/2024

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

Синтаксис

UINT MsiInstallProductW(
  [in] LPCWSTR szPackagePath,
  [in] LPCWSTR 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 Property=Setting. Дополнительные сведения см. в разделе о свойствах.

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

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

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

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

Замечания

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

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

Дополнительные сведения см. в разделе REMOVE Property.

Заметка

Заголовок msi.h определяет MsiInstallProduct как псевдоним, который автоматически выбирает версию 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, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

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

коды ошибок

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

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

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

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