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

Статья
11/20/2024

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

Синтаксис

UINT MsiAdvertiseProductW(
  [in] LPCWSTR szPackagePath,
  [in] LPCWSTR szScriptfilePath,
  [in] LPCWSTR szTransforms,
  [in] LANGID  lgidLanguage
);

Параметры

[in] szPackagePath

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

[in] szScriptfilePath

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

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

[in] szTransforms

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

[in] lgidLanguage

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

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

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

Замечания

Заметка

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

См. также

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

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