通过

MsiSourceListClearAllExA 函数 （msi.h）

  • 项目

MsiSourceListClearAllEx 函数删除指定产品或修补程序实例的给定源类型的所有现有源。 如果修补程序的唯一源被删除，并且同一上下文中的任何客户端未将修补程序安装为新修补程序，则也会删除修补程序注册。 指定 MsiSourceListClearAllEx 删除此产品的当前源或修补程序会强制安装程序下次需要源时搜索源列表。

语法

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

参数

[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 值的解释以及要清除的源类型。 此参数必须是下列MSISOURCETYPE_* 常量之一和下列MSICODE_* 常量之一的组合。

旗 意义
MSISOURCETYPE_MEDIA
 源是媒体。
MSISOURCETYPE_NETWORK
 源是网络类型。
MSISOURCETYPE_URL
 源是 URL 类型。
MSICODE_PATCH
 szProductCodeOrPatchCode 是修补程序代码。
MSICODE_PRODUCT
 szProductCodeOrPatchCode 是一个代码示例。

返回值

价值 意义
ERROR_ACCESS_DENIED
 用户无法添加或移动源。 不指示是否已找到产品或修补程序。
ERROR_BAD_CONFIGURATION
 配置数据已损坏。
ERROR_INSTALL_SERVICE_FAILURE
 无法访问 Windows Installer 服务。
ERROR_INVALID_PARAMETER
 将无效参数传递给函数。
ERROR_SUCCESS
 已删除指定类型的所有源。
ERROR_UNKNOWN_PRODUCT
 指定的产品未知。
ERROR_UNKNOWN_PATCH
 指定的修补程序未知。
ERROR_FUNCTION_FAILED
 意外的内部故障。

言论

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

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

注意

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

另请参阅

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

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

ProductCode