msi.h) (MsiAdvertiseScriptA 函数
MsiAdvertiseScript 函数将播发的脚本文件复制到指定位置。
语法
UINT MsiAdvertiseScriptA(
[in] LPCSTR szScriptFile,
[in] DWORD dwFlags,
[in] PHKEY phRegData,
[in] BOOL fRemoveItems
);
parameters
[in] szScriptFile
MsiAdvertiseProduct 或 MsiAdvertiseProductEx 生成的脚本文件的完整路径。
[in] dwFlags
SCRIPTFLAGS 控件播发中的以下位标志。 dwFlags 的值可以是以下值的组合。
[in] phRegData
一个注册表项,用于写入有关注册表数据的临时信息。 如果此参数为 null,则会根据播发是按用户还是按计算机播发,将注册表数据置于相应的键下。 如果此参数为非 null,则脚本将在指定的注册表项(而不是正常位置)下写入注册表数据。 在这种情况下,应用程序不会播发给用户。
请注意,在为用户或计算机生成产品播发时,不能使用此注册表项,因为注册表项的提供程序通常会删除该密钥。 注册表项位于 shell、类和 .msi 配置信息的正常注册表位置之外,并且不在 HKEY_CLASSES_ROOT下。 此注册表项仅用于在脚本中获取有关注册表数据的临时信息。
[in] fRemoveItems
如果要删除而不是创建指定的项,则为 TRUE。
返回值
值 | 含义 |
---|---|
|
函数已成功完成。 |
|
调用进程未在 LocalSystem 帐户下运行。 |
|
请参阅 错误代码。 |
发生与初始化相关的错误。 | |
|
此函数仅适用于 Windows 2000 和 Windows XP。 |
注解
调用此函数的进程必须在 LocalSystem 帐户下运行。 若要将每用户安装的应用程序播发给目标用户,调用此函数的线程必须模拟目标用户。 如果调用此函数的线程未模拟目标用户,则应用程序将播发给所有用户,以使用提升的权限进行安装。
注意
msi.h 标头将 MsiAdvertiseScript 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
最低受支持的客户端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer。 若要了解 Windows Installer 版本所需的最低 Windows Service Pack,请参阅 Windows Installer 运行时要求。 |
目标平台 | Windows |
标头 | msi.h |
Library | Msi.lib |
DLL | Msi.dll |