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

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

  • Статья

Функция 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.

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

[in] szTransforms

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

[in] lgidLanguage

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

[in] dwPlatform

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

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

[in] dwOptions

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

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

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

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

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