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

Статья
11/20/2024

Функция MsiProcessAdvertiseScript обрабатывает файл скрипта объявления в указанных расположениях.

Синтаксис

UINT MsiProcessAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] LPCSTR szIconFolder,
  [in] HKEY   hRegData,
  [in] BOOL   fShortcuts,
  [in] BOOL   fRemoveItems
);

Параметры

[in] szScriptFile

Полный путь к файлу скрипта, созданному MsiAdvertiseProduct или MsiAdvertiseProductEx.

[in] szIconFolder

Необязательный путь к папке, в которой находятся объявленные файлы значков и файлы преобразования. Если этот параметр null, файлы значков или преобразования не записываются.

[in] hRegData

Раздел реестра, в котором записываются данные реестра. Если этот параметр null, установщик записывает данные реестра в соответствующий ключ, исходя из того, является ли объявление на пользователя или на компьютер. Если этот параметр не являетсяNULL, скрипт записывает данные реестра в указанный раздел реестра, а не обычное расположение. В этом случае приложение не будет объявляться пользователю.

[in] fShortcuts

TRUE, если необходимо создать ярлыки. Если специальная папка возвращается SHGetSpecialFolderLocation он будет содержать ярлыки.

[in] fRemoveItems

TRUE, если указанные элементы будут удалены вместо создания.

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

Ценность	Значение
ERROR_SUCCESS	Функция успешно завершена.
ERROR_ACCESS_DENIED	Вызывающий процесс не выполнялся в учетной записи LocalSystem.
Ошибка, связанная с действием	См. коды ошибок.
ошибка инициализации	Произошла ошибка, связанная с инициализацией.
ERROR_CALL_NOT_IMPLEMENTED	Эта функция недоступна для этой платформы.

Замечания

Процесс вызова этой функции должен выполняться в учетной записи LocalSystem. Чтобы объявить приложение для установки для каждого пользователя целевому пользователю, поток, вызывающий эту функцию, должен олицетворить целевого пользователя. Если поток, вызывающий эту функцию, не олицетворяет целевого пользователя, приложение объявляется всем пользователям для установки с повышенными привилегиями.

Заметка

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

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