MsiSourceListSetInfoA 函数 (msi.h)
MsiSourceListSetInfo 函数设置有关特定上下文中产品或修补程序的源列表的信息。
语法
UINT MsiSourceListSetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[in] LPCSTR szValue
);
参数
[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 的含义。
如果正在设置的属性为“LastUsedSource”，则此参数还将源的类型指定为网络或 URL。 在这种情况下， dwOptions 参数必须是以下 MSISOURCETYPE_ 常量之一和下列 MSICODE_ 常量之一的组合。
| 标志 | 含义 |
|---|---|
|
源是网络类型。 |
|
源是 URL 类型。 |
|
szProductCodeOrPatchCode 是一个产品代码 GUID。 |
|
szProductCodeOrPatchCode 是修补程序代码 GUID。 |
[in] szProperty
参数 szProperty 指示要设置的属性值。 并非所有可以通过 MsiSourceListGetInfo 检索的属性都可以通过调用 MsiSourceListSetInfo 进行设置。 szProperty 值可以是以下值之一。
| 名称 | 含义 |
|---|---|
|
相对于安装介质根目录的路径。 |
|
提示用户输入安装介质时使用的提示模板。 |
|
产品最近使用的源位置。 如果未注册源，函数将调用 MsiSourceListAddSourceEx 来注册它。 成功注册后，函数会将源设置为 LastUsedSource。 |
|
源上的 Windows Installer 程序包或补丁程序包的名称。 |
[in] szValue
属性的新值。 不执行新值的验证。 此值不能为 NULL。 它可以是空字符串。
返回值
MsiSourceListSetInfo 函数返回以下值。
| 值 | 含义 |
|---|---|
|
用户无法设置指定产品的源列表。 |
|
配置数据已损坏。 |
|
无法访问 Windows Installer 服务。 |
|
向该函数传递了无效参数。 |
|
属性已设置。 |
|
找不到修补程序。 |
|
找不到产品。 |
|
找不到源属性。 |
|
意外的内部故障。 |
注解
管理员可以修改在计算机上下文下或在其自己的每用户上下文中存在的产品或修补程序实例的安装 (托管或非托管。) 他们可以修改任何用户按用户管理的上下文下存在的产品或修补程序实例的安装。 管理员无法修改其他用户安装的产品或修补程序实例，该实例存在于该其他用户的每用户非托管上下文中。
非管理员无法修改另一用户每用户上下文中存在的产品或修补程序实例的安装 (托管或非托管。) 他们可以修改在其自己的每用户非托管上下文下存在的产品或修补程序实例的安装。 仅当允许他们浏览产品或修补程序源时，他们才能在计算机上下文或其自己的按用户管理的上下文下修改产品或修补程序实例的安装。 用户可以通过设置策略来浏览源。 有关详细信息，请参阅 DisableBrowse、 AllowLockdownBrowse 和 AlwaysInstallElevated 策略。
上述规则的例外是将“LastUsedSource”设置为已注册的源之一。 如果源已注册，则非管理员可以将“LastUsedSource”设置为自己的安装， (托管或非托管) 和每台计算机安装，而不考虑策略。
注意
msi.h 标头将 MsiSourceListSetInfo 定义为别名，该别名根据 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 |