MsiSourceListForceResolutionExA 函数 (msi.h)

  • 项目

MsiSourceListForceResolutionEx 函数删除名为“LastUsedSource”的属性注册。 此函数不影响已注册的源列表。 每当安装程序要求源重新安装产品或修补程序时，它首先会尝试注册为“LastUsedSource”的源。 如果失败，或者缺少该注册，安装程序将搜索其他已注册的源，直到找到有效的源或源列表用尽。 清除“LastUsedSource”注册将强制安装程序在下次需要源时针对已注册的源执行源解析。

语法

UINT MsiSourceListForceResolutionExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions
);

parameters

[in] szProductCodeOrPatchCode

产品或修补程序的 ProductCode 或修补程序 GUID。 使用以 null 结尾的字符串。 如果字符串长度超过 39 个字符，则函数将失败并返回ERROR_INVALID_PARAMETER。 此参数不能为 NULL。

[in, optional] szUserSid

此参数可以是指定包含产品或修补程序的用户帐户的字符串 SID。 SID 未验证或解析。 错误的 SID 可能会返回ERROR_UNKNOWN_PRODUCT或ERROR_UNKNOWN_PATCH。 引用计算机上下文时， szUserSID 必须为 NULL ， dwContext 必须MSIINSTALLCONTEXT_MACHINE。 使用计算机 SID (“S-1-5-18”) 返回ERROR_INVALID PARAMETER。 引用当前用户帐户时， szUserSID 可以为 NULL ， dwContext 可以MSIINSTALLCONTEXT_USERMANAGED或MSIINSTALLCONTEXT_USERUNMANAGED。

[in] dwContext

此参数指定产品或修补程序实例的上下文。 此参数可以包含以下值之一。

上下文类型 含义
MSIINSTALLCONTEXT_USERMANAGED
 产品或修补程序实例存在于每用户管理的上下文中。
MSIINSTALLCONTEXT_USERUNMANAGED
 产品或修补程序实例存在于每用户非托管上下文中。
MSIINSTALLCONTEXT_MACHINE
 产品或修补程序实例存在于每台计算机上下文中。

[in] dwOptions

dwOptions 值确定 szProductCodeOrPatchCode 值 的解释。

标志 含义
MSICODE_PRODUCT
 szProductCodeOrPatchCode 是一个产品代码。
MSICODE_PATCH
 szProductCodeOrPatchCode 是一个修补程序代码。

返回值

MsiSourceListForceResolutionEx 函数返回以下值。

值 含义
ERROR_ACCESS_DENIED
 用户无法修改指定的源列表。 不指示是否找到产品或修补程序。
ERROR_BAD_CONFIGURATION
 配置数据已损坏。
ERROR_INSTALL_SERVICE_FAILURE
 无法访问 Windows Installer 服务
ERROR_INVALID_PARAMETER
 向该函数传递了无效参数。
ERROR_SUCCESS
 “LastUsedSource”注册已清除。
ERROR_UNKNOWN_PATCH
 找不到修补程序。
ERROR_UNKNOWN_PRODUCT
 找不到指定的产品或修补程序。
ERROR_FUNCTION_FAILED
 意外的内部故障。

注解

管理员可以修改在计算机上下文下或在其自己的每用户上下文下存在的产品或修补程序实例的安装， (托管或非托管。) 他们可以修改在任何用户的按用户管理的上下文下存在的产品或修补程序实例的安装。 管理员无法修改其他用户安装的产品或修补程序实例，该实例存在于该其他用户的每用户非托管上下文下。

非管理员无法修改其他用户的每用户上下文中存在的产品或修补程序实例的安装 (托管或非托管。) 他们可以修改在其自己的每用户非托管上下文下存在的产品或修补程序实例的安装。 仅当允许他们浏览产品或修补程序源时，他们才能在计算机上下文或其自己的按用户管理的上下文下修改产品或修补程序实例的安装。 用户可以通过设置策略来浏览源。有关详细信息，请参阅 DisableBrowse、 AllowLockdownBrowse 和 AlwaysInstallElevated 策略。

注意

msi.h 标头将 MsiSourceListForceResolutionEx 定义为别名，该别名根据 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

另请参阅

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

ProductCode

源复原能力