通过

MsiExtractPatchXMLDataA 函数 （msi.h）

  • 项目

MsiExtractPatchXMLData 函数从可用于确定修补程序是否适用于目标系统的修补程序中提取信息。 该函数返回一个 XML 字符串，该字符串可以提供给 MsiDeterminePatchSequence，MsiDetermineApplicablePatches 而不是完整的修补文件。 返回的信息可用于确定修补程序是否适用。

语法

UINT MsiExtractPatchXMLDataA(
  [in]                LPCSTR  szPatchPath,
  [in]                DWORD   dwReserved,
  [out, optional]     LPSTR   szXMLData,
  [in, out, optional] LPDWORD pcchXMLData
);

参数

[in] szPatchPath

要查询的修补程序的完整路径。 作为以 null 结尾的字符串传入。 此参数不能 NULL。

[in] dwReserved

必须为 0（零）的保留参数。

[out, optional] szXMLData

指向缓冲区的指针，用于保存包含提取的修补程序信息的 XML 字符串。 此缓冲区应足够大，足以包含收到的信息。 如果缓冲区太小，则该函数将返回ERROR_MORE_DATA并将 *pcchXMLData 设置为值中的 TCHAR 数，不包括终止 NULL 字符。

如果 szXMLData 设置为 NULL，并且 pcchXMLData 设置为有效指针，则该函数将返回ERROR_SUCCESS并将 *pcchXMLData 设置为值中 TCHAR 的数量，不包括终止 NULL 字符。 然后，可以再次调用该函数来检索值，szXMLData 缓冲区足够大，足以包含 *pcchXMLData + 1 个字符。

[in, out, optional] pcchXMLData

指向一个变量的指针，该变量指定 szXMLData 缓冲区中 TCHAR 的数目。 当函数返回时，无论函数是否将值复制到指定的缓冲区，此参数都设置为所请求值的大小。 大小返回为请求值中 TCHAR 的数量，不包括终止 null 字符。

如果此参数设置为 NULL，则该函数将返回ERROR_INVALID_PARAMETER。

返回值

MsiExtractPatchXMLData 函数可以返回以下值。

返回代码 描述
ERROR_FUNCTION_FAILED
 此函数失败的方式不是由此表中任何返回值标识的。
ERROR_INVALID_PARAMETER
 将无效参数传递给函数。
ERROR_MORE_DATA
 该值不适合提供的缓冲区。
ERROR_PATCH_OPEN_FAILED
 无法打开修补程序文件。
ERROR_SUCCESS
 函数成功。
ERROR_PATCH_PACKAGE_INVALID
 无法打开修补程序文件。
ERROR_CALL_NOT_IMPLEMENTED
 如果未安装 MSXML 3.0，则可以返回此错误。

言论

Installer 对象的 ExtractPatchXMLData 方法使用 MsiExtractPatchXMLData 函数。

注意

msi.h 标头将 MsiExtractPatchXMLData 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 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

另请参阅

MsiDetermineApplicablePatches

MsiDeterminePatchSequence

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