msi.h) (MsiGetProductInfoFromScriptA 函数

  • 项目

MsiGetProductInfoFromScript 函数返回 Windows Installer 脚本文件的产品信息。

语法

UINT MsiGetProductInfoFromScriptA(
  [in]      LPCSTR  szScriptFile,
  [out]     LPSTR   lpProductBuf39,
  [out]     LANGID  *plgidLanguage,
  [out]     LPDWORD pdwVersion,
  [out]     LPSTR   lpNameBuf,
  [in, out] LPDWORD pcchNameBuf,
  [out]     LPSTR   lpPackageBuf,
  [in, out] LPDWORD pcchPackageBuf
);

参数

[in] szScriptFile

以 null 结尾的字符串，指定脚本文件的完整路径。 脚本文件是通过调用 MsiAdvertiseProduct 或 MsiAdvertiseProductEx 创建的播发脚本。

[out] lpProductBuf39

指向接收产品代码的缓冲区。 缓冲区的长度必须为 39 个字符。 前 38 个字符表示产品代码 GUID，最后一个字符表示终止 null 字符。

[out] plgidLanguage

指向接收产品语言的变量。

[out] pdwVersion

指向接收产品版本的缓冲区。

[out] lpNameBuf

指向接收产品名称的缓冲区。 缓冲区包含终止 null 字符。

[in, out] pcchNameBuf

指向一个变量，该变量指定 lpNameBuf 参数指向的缓冲区的大小（以字符为单位）。 此大小应包括结尾的 null 字符。 当函数返回时，此变量包含存储在缓冲区中的字符串的长度。 返回的计数不包括终止 null 字符。 如果缓冲区不够大，函数将返回ERROR_MORE_DATA，并且变量包含字符串的大小（以字符为单位），而不计算 null 字符。

[out] lpPackageBuf

指向接收包名称的缓冲区。 缓冲区包含终止 null 字符。

[in, out] pcchPackageBuf

指向一个变量，该变量指定 lpPackageNameBuf 参数指向的缓冲区的大小（以字符为单位）。 此大小应包括结尾的 null 字符。 当函数返回时，此变量包含存储在缓冲区中的字符串的长度。 返回的计数不包括终止 null 字符。 如果缓冲区不够大，函数将返回ERROR_MORE_DATA，并且变量包含字符串的大小（以字符为单位），而不计算 null 字符。

返回值

值 含义
ERROR_SUCCESS
 函数已成功完成。
ERROR_INVALID_PARAMETER
 传递给函数的参数无效。
ERROR_MORE_DATA
 缓冲区太小，无法容纳整个值。
ERROR_INSTALL_FAILURE
 无法获取脚本信息。
ERROR_CALL_NOT_IMPLEMENTED
 此函数仅适用于 Windows 2000 和 Windows XP。

注解

注意

msi.h 标头将 MsiGetProductInfoFromScript 定义为别名，该别名根据 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