MsiSourceListAddSourceExW 函数 (msi.h)

  • 项目

MsiSourceListAddSourceEx 函数在指定上下文中添加或重新排序修补程序或产品的源集。 它还可以为指定上下文中不存在的修补程序创建源列表。

语法

UINT MsiSourceListAddSourceExW(
  [in]           LPCWSTR           szProductCodeOrPatchCode,
  [in, optional] LPCWSTR           szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           LPCWSTR           szSource,
  [in, optional] DWORD             dwIndex
);

参数

[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 的类型 含义
NULL
 NULL 表示当前登录的用户。 引用当前用户帐户时，szUserSID 可以为 NULL，dwContext 可以是MSIINSTALLCONTEXT_USERMANAGED或MSIINSTALLCONTEXT_USERUNMANAGED。
用户 SID
 指定系统中特定用户的枚举。 用户 SID 的示例是“S-1-3-64-2415071341-1358098788-3127455600-2561”。
 
注意 特殊的 SID 字符串 s-1-5-18 (系统) 不能用于枚举按计算机安装的产品或修补程序。 将 SID 值设置为“S-1-5-18”将返回 ERROR_INVALID_PARAMETER。
 
注意 不应使用特殊 SID 字符串 s-1-1-0 () 所有人。 将 SID 值设置为“S-1-1-0”失败，并返回 ERROR_INVALID_PARAM。
 

[in] dwContext

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

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

[in] dwOptions

dwOptions 值确定 szProductCodeOrPatchCode 值的解释以及要清除的源类型。 此参数必须是以下 MSISOURCETYPE_ 常量之一和下列 MSICODE_ 常量之一的组合。

标志 含义
MSISOURCETYPE_NETWORK
 源是网络类型。
MSISOURCETYPE_URL
 源是 URL 类型。
MSICODE_PRODUCT
 szProductCodeOrPatchCode 是一个产品代码。
MSICODE_PATCH
 szProductCodeOrPatchCode 是一个修补程序代码。

[in] szSource

要添加或移动的源。 此参数应仅包含不带文件名的路径。 文件名已注册为“PackageName”，可以通过 MsiSourceListSetInfo 进行操作。 此参数是必需的参数。

[in, optional] dwIndex

此参数为源提供新索引。 源列表中所有源的索引从 1 到 N，其中 N 是列表中的源计数。 列表中的每个源都有唯一的索引。

如果使用新源调用 MsiSourceListAddSourceEx ，并将 dwIndex 设置为 0 (零) ，则会将新源追加到现有列表中。 如果 dwIndex 设置为 0，并且列表中已存在源，则不会对列表执行任何更新。

如果使用新源调用 MsiSourceListAddSourceEx 并将 dwIndex 设置为小于 count (N) 的非零值，则新源将放置在指定的索引处，并重新索引其他源。 如果源已存在，则会将其移动到指定的索引，并重新索引其他源。

如果使用新源调用 MsiSourceListAddSourceEx ，并将 dwIndex 设置为大于 N) (源计数的非零值，则会将新源追加到现有列表中。 如果源已存在，则会将其移动到列表的末尾，并重新为其他源编制索引。

返回值

MsiSourceListAddSourceEx 函数返回以下值。

值 含义
ERROR_ACCESS_DENIED
 用户无法添加或移动源。 不指示是否已找到产品或修补程序。
ERROR_BAD_CONFIGURATION
 配置数据已损坏。
ERROR_INSTALL_SERVICE_FAILURE
 无法访问 Windows Installer 服务。
ERROR_SUCCESS
 已插入或更新源。
ERROR_UNKNOWN_PRODUCT
 指定的产品未知。
ERROR_UNKNOWN_PATCH
 指定的修补程序未知。
ERROR_FUNCTION_FAILED
 意外的内部故障。

注解

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

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

注意

msi.h 标头将 MsiSourceListAddSourceEx 定义为别名，该别名根据 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 Installer 版本所需的最低 Windows Service Pack 的信息，请参阅 Windows Installer 运行时要求。
目标平台 Windows
标头 msi.h
Library Msi.lib
DLL Msi.dll

另请参阅

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

MsiSourceListSetInfo

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

ProductCode

源复原能力