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

Статья
08/24/2023

Функция MsiAdvertiseProduct создает скрипт объявления или объявляет продукт на компьютере. Функция MsiAdvertiseProduct позволяет установщику записывать в скрипт сведения о реестре и ярлыке, используемые для назначения или публикации продукта. Скрипт можно написать в соответствии с указанной платформой с помощью MsiAdvertiseProductEx.

Синтаксис

UINT MsiAdvertiseProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage
);

Параметры

[in] szPackagePath

Полный путь к пакету объявляемого продукта.

[in] szScriptfilePath

Полный путь к файлу скрипта, который будет создан с информацией об объявлении. Чтобы объявить продукт локально на компьютере, задайте ADVERTISEFLAGS_MACHINEASSIGN или ADVERTISEFLAGS_USERASSIGN.

Flag	Значение
ADVERTISEFLAGS_MACHINEASSIGN 0	Задайте для объявления установки продукта для каждого компьютера, доступного для всех пользователей.
ADVERTISEFLAGS_USERASSIGN 1	Задайте значение , чтобы объявить установку продукта для каждого пользователя, доступную для конкретного пользователя.

[in] szTransforms

Список преобразований, разделенных точкой с запятой. Список преобразований может иметь префикс @ или | character для указания безопасного кэширования преобразований. Префикс @ указывает безопасные преобразования в источнике и | префикс указывает безопасные преобразования полного пути. Дополнительные сведения см. в разделе Защищенные преобразования. Этот параметр может быть равен null.

[in] lgidLanguage

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

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

Значение	Значение
ERROR_SUCCESS	Функция успешно завершена.
Ошибка, связанная с действием	См . коды ошибок.
Ошибка инициализации	Произошла ошибка при инициализации.
ERROR_CALL_NOT_IMPLEMENTED	Эта ошибка возвращается, если предпринята попытка создать скрипт объявления на любой платформе, отличной от Windows 2000 или Windows XP. Объявление на локальном компьютере поддерживается на всех платформах.

Заголовок msi.h определяет MsiAdvertiseProduct в качестве псевдонима, который автоматически выбирает версию 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.
Целевая платформа	Windows
Header	msi.h
Библиотека	Msi.lib
DLL	Msi.dll

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

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

Share via