msiDetermineApplicablePatchesA 函数 (msi.h)

  • 项目

MsiDetermineApplicablePatches 函数采用一组修补程序文件、XML 文件和 XML Blob，并确定哪些修补程序适用于指定的 Windows Installer 包以及按何种顺序应用。 函数可以用来解释被取代或过时的修补程序。 此函数未考虑系统上安装的产品或修补程序，集中未指定这些产品或修补程序。

语法

UINT MsiDetermineApplicablePatchesA(
  [in] LPCSTR                 szProductPackagePath,
  [in] DWORD                  cPatchInfo,
  [in] PMSIPATCHSEQUENCEINFOA pPatchInfo
);

parameters

[in] szProductPackagePath

.msi 文件的完整路径。 函数确定适用于此包的修补程序以及按何种顺序排列。

[in] cPatchInfo

数组中的修补程序数。 必须大于零。

[in] pPatchInfo

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

返回值

MsiDetermineApplicablePatches 函数返回以下值。

值 含义
ERROR_FUNCTION_FAILED
 函数失败的方式未包含在其他错误代码中。
ERROR_INVALID_PARAMETER
 参数无效。
ERROR_PATCH_NO_SEQUENCE
 找不到修补程序集的有效顺序。
ERROR_SUCCESS
 已成功对补丁进行排序。
ERROR_FILE_NOT_FOUND
 找不到 .msi 文件。
ERROR_PATH_NOT_FOUND
 找不到 .msi 文件的路径。
ERROR_INVALID_PATCH_XML
 XML 修补程序数据无效。
ERROR_INSTALL_PACKAGE_OPEN_FAILED
 无法打开路径引用的安装包。
ERROR_CALL_NOT_IMPLEMENTED
 如果函数是从 自定义操作 调用的，或者如果未安装 MSXML 3.0，则可能会返回此错误。

注解

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

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

如果函数成功，可应用于产品的每个修补程序的 MSIPATCHSEQUENCEINFO 结构将返回 uStatus ERROR_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 标头将 MsiDetermineApplicablePatches 定义为别名，该别名根据 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 3.0 或更高版本。 若要了解 Windows Installer 版本所需的最低 Windows Service Pack，请参阅 Windows Installer 运行时要求。
目标平台 Windows
标头 msi.h
Library Msi.lib
DLL Msi.dll

另请参阅

MsiDeterminePatchSequence

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

ProductCode