MsiSourceListAddSourceExA 函数 (msi.h)
MsiSourceListAddSourceEx 函数在指定上下文中添加修补程序或产品的源集或重新排序。 它还可以为指定上下文中不存在的修补程序创建源列表。
语法
UINT MsiSourceListAddSourceExA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szSource,
[in, optional] DWORD dwIndex
);
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。
[in] dwContext
此参数指定产品或修补程序实例的上下文。 此参数可以包含以下值之一。
上下文类型 | 含义 |
---|---|
|
产品或修补程序实例存在于每用户管理的上下文中。 |
|
产品或修补程序实例存在于每用户非托管上下文中。 |
|
产品或修补程序实例存在于每台计算机上下文中。 |
[in] dwOptions
dwOptions 值确定 szProductCodeOrPatchCode 值的解释以及要清除的源类型。 此参数必须是下列 MSISOURCETYPE_ 常量之一和下列 MSICODE_ 常量之一的组合。
标志 | 含义 |
---|---|
|
源是网络类型。 |
|
源是 URL 类型。 |
|
szProductCodeOrPatchCode 是一个产品代码。 |
|
szProductCodeOrPatchCode 是一个修补程序代码。 |
[in] szSource
要添加或移动的源。 此参数应仅包含不带文件名的路径。 文件名已注册为“PackageName”,可以通过 MsiSourceListSetInfo 进行操作。 此参数是必需的参数。
[in, optional] dwIndex
此参数为源提供新索引。 所有源在源列表中从 1 到 N 编制索引,其中 N 是列表中源的计数。 列表中的每个源都有唯一的索引。
如果使用新源调用 MsiSourceListAddSourceEx ,并且 dwIndex 设置为 0 (零) ,则新源将追加到现有列表中。 如果 dwIndex 设置为 0,并且列表中已存在源,则不会对列表执行任何更新。
如果使用新源调用 MsiSourceListAddSourceEx ,并将 dwIndex 设置为小于 count (N) 的非零值,则将新源放置在指定的索引处,并重新索引其他源。 如果源已存在,则会将其移动到指定的索引,并重新为其他源编制索引。
如果使用新源调用 MsiSourceListAddSourceEx ,并将 dwIndex 设置为大于 N) (源计数的非零值,则新源将追加到现有列表。 如果源已存在,则会将其移动到列表末尾,并重新为其他源编制索引。
返回值
MsiSourceListAddSourceEx 函数返回以下值。
值 | 含义 |
---|---|
|
用户无法添加或移动源。 不指示是否找到产品或修补程序。 |
|
配置数据已损坏。 |
|
无法访问 Windows Installer 服务。 |
|
已插入或更新源。 |
|
指定的产品未知。 |
|
指定的修补程序未知。 |
|
意外的内部故障。 |
注解
管理员可以修改在计算机上下文下或在其自己的每用户上下文下存在的产品或修补程序实例的安装, (托管或非托管。) 他们可以修改在任何用户的按用户管理的上下文下存在的产品或修补程序实例的安装。 管理员无法修改其他用户安装的产品或修补程序实例,该实例存在于该其他用户的每用户非托管上下文下。
非管理员无法修改其他用户的每用户上下文中存在的产品或修补程序实例的安装 (托管或非托管。) 他们可以修改在其自己的每用户非托管上下文下存在的产品或修补程序实例的安装。 仅当允许他们浏览产品或修补程序源时,他们才能在计算机上下文或其自己的按用户管理的上下文下修改产品或修补程序实例的安装。 用户可以通过设置策略来浏览源。 有关详细信息,请参阅 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 |