MsiDetermineApplicablePatchesA 函数 (msi.h)

MsiDetermineApplicablePatches 函数采用一组修补程序文件、XML 文件和 XML blob,并确定哪些修补程序适用于指定的 Windows Installer 包以及哪个序列。 该函数可以考虑被取代或过时的修补程序。 此函数不考虑在集中未指定的系统上安装的产品或修补程序。

语法

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

参数

[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 函数设置 uStatusdwOrder 每个 MSIPATCHSEQUENCEINFO 结构所指向 pPatchInfo。 每个结构都包含有关特定修补程序的信息。

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

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

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

另请参阅

MsiDeterminePatchSequence

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

ProductCode