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

Статья
11/20/2024

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

Синтаксис

UINT MsiAdvertiseProductExA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage,
  [in] DWORD  dwPlatform,
  [in] DWORD  dwOptions
);

Параметры

[in] szPackagePath

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

[in] szScriptfilePath

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

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

[in] szTransforms

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

[in] lgidLanguage

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

[in] dwPlatform

Битовые флаги, управляющие тем, для какой платформы установщик должен создать скрипт. Этот параметр игнорируется, если szScriptfilePath имеет значение NULL. Если dwPlatform равно нулю (0), скрипт создается на основе текущей платформы. Это та же функция, что и MsiAdvertiseProduct. Если dwPlatform равно 1 или 2, установщик создает скрипт для указанной платформы.

Флаг	Значение
нет 0	Создает скрипт для текущей платформы.
MSIARCHITECTUREFLAGS_X86 1	Создает скрипт для платформы x86.
MSIARCHITECTUREFLAGS_IA64 2	Создает скрипт для систем на основе Itanium.
MSIARCHITECTUREFLAGS_AMD64 4	Создает скрипт для платформы x64.

[in] dwOptions

Битовые флаги, указывающие дополнительные параметры рекламы. Значение nonzero доступно только в версиях установщика Windows, которые поставляется с Windows Server 2003 и Windows XP с пакетом обновления 1 (SP1) и более поздних версий.

Флаг	Значение
MSIADVERTISEOPTIONS_INSTANCE 1	Несколько экземпляров с помощью кода продукта, изменяющего флаг поддержки преобразования. Объявляет новый экземпляр продукта. Требует, чтобы параметр szTransforms включает преобразование экземпляра, которое изменяет код продукта. Дополнительные сведения см. в установке нескольких экземпляров продуктов и исправлений.

Флаг

Значение

MSIADVERTISEOPTIONS_INSTANCE
1

Несколько экземпляров с помощью кода продукта, изменяющего флаг поддержки преобразования. Объявляет новый экземпляр продукта. Требует, чтобы параметр szTransforms включает преобразование экземпляра, которое изменяет код продукта. Дополнительные сведения см. в установке нескольких экземпляров продуктов и исправлений.

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

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

Замечания

Для доставки версий установщика Windows с windows Server 2003 и Windows XP с пакетом обновления 1 (SP1) и более поздних версий доступно несколько экземпляров с помощью кода продукта.

Заметка

Заголовок msi.h определяет MsiAdvertiseProductEx как псевдоним, который автоматически выбирает версию 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 установки

не поддерживается в установщике Windows 2.0 и более ранних

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