通过

MsiDeterminePatchSequenceA 函数 （msi.h）

  • 项目

MsiDeterminePatchSequence 函数采用一组修补程序文件、XML 文件和 XML blob，并确定修补程序到指定已安装产品的最佳应用程序序列。 此函数用于已应用于产品的修补程序以及已过时和取代修补程序的帐户。

语法

UINT MsiDeterminePatchSequenceA(
  [in]           LPCSTR                 szProductCode,
  [in, optional] LPCSTR                 szUserSid,
  [in]           MSIINSTALLCONTEXT      dwContext,
  [in]           DWORD                  cPatchInfo,
  [in]           PMSIPATCHSEQUENCEINFOA pPatchInfo
);

参数

[in] szProductCode

产品是修补程序集的目标。 该值必须是产品的 ProductCode GUID。

[in, optional] szUserSid

以 Null 结尾的字符串，指定用户的安全标识符（SID）。 此参数限制此用户帐户的枚举上下文。 此参数不能是特殊的 SID 字符串“S-1-1-0”（每个人）或“S-1-5-18”（本地系统）。 对于计算机上下文 dwContext 设置为 MSIINSTALLCONTEXT_MACHINE，szUserSid 必须 NULL。 对于当前用户上下文 szUserSid 可以为 null，dwContext 可以设置为 MSIINSTALLCONTEXT_USERMANAGED 或 MSIINSTALLCONTEXT_USERUNMANAGED。

[in] dwContext

将枚举限制为按用户非托管、按用户托管或每台计算机上下文。 此参数可以是以下任一值。

上下文类型 意义
MSIINSTALLCONTEXT_USERMANAGED
 对于由 szUserSid指定的用户，所有按用户管理的安装都考虑修补程序。 具有此上下文的 null szUserSid 表示当前用户。
MSIINSTALLCONTEXT_USERUNMANAGED
 对于由 szUserSid指定的用户的所有每用户非托管安装，都会考虑修补程序。 具有此上下文的 null szUserSid 表示当前用户。
MSIINSTALLCONTEXT_MACHINE
 对于每台计算机安装，会考虑修补程序。 当 dwContext 设置为 MSIINSTALLCONTEXT_MACHINE szUserSid 参数 必须为 null。

[in] cPatchInfo

数组中的修补程序数。

[in] pPatchInfo

指向 MSIPATCHSEQUENCEINFO 结构的数组的指针。

返回值

MsiDeterminePatchSequence 函数返回以下值。

价值 意义
ERROR_FUNCTION_FAILED
 该函数以其他错误代码中未涵盖的方式失败。
ERROR_INVALID_PARAMETER
 参数无效。
ERROR_PATCH_NO_SEQUENCE
 找不到修补程序集的有效序列。
ERROR_INSTALL_PACKAGE_OPEN_FAILED
 无法打开路径引用的安装包。
ERROR_SUCCESS
 修补程序已成功排序。
ERROR_FILE_NOT_FOUND
 找不到 .msi 文件。
ERROR_PATH_NOT_FOUND
 找不到 .msi 文件的路径。
ERROR_INVALID_PATCH_XML
 XML 修补数据无效。
ERROR_INSTALL_PACKAGE_INVALID
 安装包无效。
ERROR_ACCESS_DENIED
 不是管理员的用户尝试使用其他用户的上下文调用函数。
ERROR_BAD_CONFIGURATION
 已注册的修补程序或产品的配置数据无效。
ERROR_UNKNOWN_PRODUCT
 未注册指定的 ProductCode GUID。
ERROR_FUNCTION_NOT_CALLED
 需要 Windows Installer 版本 3.0 才能确定最佳修补程序序列。 该函数是使用 szProductCode 尚未随 Windows Installer 版本 3.0 一起安装的。
ERROR_CALL_NOT_IMPLEMENTED
 如果未安装 MSXML 3.0，则可以从 自定义操作 调用函数时返回此错误。
ERROR_UNKNOWN_PATCH
 指定的修补程序未知。

言论

没有管理员权限的用户只能在自己的或计算机上下文中调用此函数。 管理员用户可以为其他用户调用它。

如果从自定义操作调用此函数，它将失败并返回 ERROR_CALL_NOT_IMPLEMENTED。 该函数需要 MSXML 版本 3.0 来处理 XML，并在未安装 MSXML 3.0 时返回 ERROR_CALL_NOT_IMPLEMENTED。

MsiDeterminePatchSequence 函数设置 uStatus 和 dwOrder MSIPATCHSEQUENCEINFO 结构指向的每个 MSIPATCHSEQUENCEINFO 结构。 每个结构都包含有关特定修补程序的信息。

如果函数成功，则 MSIPATCHSEQUENCEINFO 每个可应用于产品的修补程序的结构返回 uStatusERROR_SUCCESS，dwOrder 大于或等于零。 dwOrder 大于或等于零的值表示从零开始的修补程序的最佳应用程序序列。

如果函数成功，则从最佳修补序列中排除的修补程序返回 MSIPATCHSEQUENCEINFO 结构，dwOrder 等于 -1。 在这些情况下，uStatus 字段 ERROR_SUCCESS 指示已过时或取代产品的修补程序。 ERROR_PATCH_TARGET_NOT_FOUND 的 uStatus 字段指示无法应用于产品的修补程序。

如果函数失败，则每个修补程序的 MSIPATCHSEQUENCEINFO 结构将返回一个 dwOrder 等于 -1。 在这种情况下，uStatus 字段可能包含有关各个修补程序的详细信息的错误。 例如，对于具有循环排序信息的修补程序，将返回 ERROR_PATCH_NO_SEQUENCE。

注意

msi.h 标头将 MsiDeterminePatchSequence 定义为一个别名，该别名根据 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 Installer 版本所需的最低 Windows Service Pack 的信息，请参阅 Windows Installer Run-Time 要求。
目标平台 窗户
标头 msi.h
库 Msi.lib
DLL Msi.dll

另请参阅

MSIPATCHSEQUENCEINFO

MsiDetermineApplicablePatches

Windows Installer 2.0 及更早版本中不支持

ProductCode