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
);

parameters

[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_MACHINEszUserSid 参数必须为 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 函数设置 pPatchInfo 指向的每个 MSIPATCHSEQUENCEINFO 结构的 uStatus 和 dwOrder 成员。 每个结构都包含有关特定修补程序的信息。

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

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

如果函数失败，则每个修补程序的 MSIPATCHSEQUENCEINFO 结构将返回等于 -1 的 dwOrder 。 在这种情况下， 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 运行时要求。
目标平台 Windows
标头 msi.h
Library Msi.lib
DLL Msi.dll

另请参阅

MSIPATCHSEQUENCEINFO

MsiDetermineApplicablePatches

在 Windows Installer 2.0 及更低版本中不受支持

ProductCode