MsiAdvertiseProductExA 函数 （msi.h）
MsiAdvertiseProductEx 函数生成播发脚本或将产品播发到计算机。 此函数使 Windows Installer 能够写入用于分配或发布产品的注册表和快捷方式信息的脚本。 可以使用 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。
| 旗 | 意义 |
|---|---|
|
设置为播发可供所有用户使用的产品的每台计算机安装。 |
|
设置为播发特定用户可用的产品的按用户安装。 |
[in] szTransforms
要应用的转换的分号分隔列表。 转换列表可以带有 @ 或 | 前缀用于指定转换的安全缓存的字符。 @ 前缀指定源安全转换和 |prefix 指示安全的完整路径转换。 有关详细信息，请参阅 安全转换。 此参数可能为 null。
[in] lgidLanguage
如果源支持多种语言，则使用的语言。
[in] dwPlatform
用于控制安装程序应为其创建脚本的平台的位标志。 如果 szScriptfilePath 为 null，则忽略此参数。 如果 dwPlatform 为零（0），则根据当前平台创建脚本。 此功能与 MsiAdvertiseProduct相同。 如果 dwPlatform 为 1 或 2，安装程序将为指定的平台创建脚本。
| 旗 | 意义 |
|---|---|
|
为当前平台创建脚本。 |
|
为 x86 平台创建脚本。 |
|
为基于 Itanium 的系统创建脚本。 |
|
为 x64 平台创建脚本。 |
[in] dwOptions
指定额外播发选项的位标志。 非零值仅适用于随 Windows Server 2003 和 Windows XP 以及 SP1 及更高版本一起提供的 Windows Installer 版本。
| 旗 | 意义 |
|---|---|
|
通过产品代码更改转换支持标志的多个实例。 播发产品的新实例。 要求 szTransforms 参数包含更改代码示例的实例转换。 有关详细信息，请参阅 安装多个产品和修补程序实例。 |
返回值
| 价值 | 意义 |
|---|---|
|
函数成功完成。 |
|
有关详细信息，请参阅 错误代码。 |
| 已发生初始化错误。 | |
|
如果尝试在除 Windows 2000 或 Windows XP 以外的任何平台上生成播发脚本，则返回此错误。 所有平台上都支持向本地计算机播发。 |
言论
通过产品代码更改转换的多个实例仅适用于随 Windows Server 2003 和 Windows XP 附带 SP1 及更高版本的 Windows Installer 版本。
注意
msi.h 标头将 MsiAdvertiseProductEx 定义为一个别名，该别名根据 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 Run-Time 要求。 |
| 目标平台 | 窗户 |
| 标头 | msi.h |
| 库 | Msi.lib |
| DLL | Msi.dll |