MsiSourceListAddMediaDiskA 函数 (msi.h)
MsiSourceListAddMediaDisk 函数添加或更新已注册产品或修补程序的媒体源的磁盘。 如果指定的磁盘已存在,则会使用新值进行更新。 如果指定的磁盘不存在,则会使用新值创建新的磁盘条目。
语法
UINT MsiSourceListAddMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCSTR szVolumeLabel,
[in, optional] LPCSTR szDiskPrompt
);
参数
[in] szProductCodeOrPatchCode
ProductCode 或修补程序 GUID 的产品或修补程序。 使用以 null 结尾的字符串。 如果字符串长度超过 39 个字符,则函数将失败并返回ERROR_INVALID_PARAMETER。 此参数不能 NULL。
[in, optional] szUserSid
此参数可以是指定包含产品或修补程序的用户帐户的字符串 SID。 SID 未验证或解析。 不正确的 SID 可以返回ERROR_UNKNOWN_PRODUCT或ERROR_UNKNOWN_PATCH。
[in] dwContext
此参数指定产品或修补程序实例的上下文。 此参数可以包含以下值之一。
上下文类型 | 意义 |
---|---|
|
产品或修补程序实例存在于每个用户管理的上下文中。 |
|
产品或修补程序实例存在于每用户非托管上下文中。 |
|
产品或修补程序实例存在于每台计算机上下文中。 |
[in] dwOptions
dwOptions 值指定 szProductCodeOrPatchCode的含义。
旗 | 意义 |
---|---|
|
szProductCodeOrPatchCode 是一个代码示例 GUID。 |
|
szProductCodeOrPatchCode 是修补程序代码 GUID。 |
[in] dwDiskId
此参数提供要添加或更新的磁盘的 ID。
[in] szVolumeLabel
szVolumeLabel 提供要添加或更新的磁盘的标签。 更新将覆盖注册表中的现有卷标签。 若要仅更改磁盘提示,请从注册表获取现有卷标签,并在此调用中提供该卷标签以及新的磁盘提示。 为 szVolumeLabel 传递 NULL 或空字符串 将空字符串(长度为 0 字节)注册为卷标签。
[in, optional] szDiskPrompt
在 MsiSourceListAddMediaDisk条目时,szDiskPrompt 提供正在添加或更新磁盘的磁盘提示。 更新会覆盖已注册的磁盘提示。
若要仅更改卷标签,请获取注册的现有磁盘提示,并在调用 MsiSourceListAddMediaDisk 以及新的卷标签时提供它。 将 NULL 或空字符串作为磁盘提示注册空字符串(长度为 0 字节)。
返回值
MsiSourceListAddMediaDisk 函数返回以下值。
价值 | 意义 |
---|---|
|
用户无法读取指定的媒体源或指定的产品或修补程序。 这并不指示是否已找到媒体源、产品或修补程序。 |
|
配置数据已损坏。 |
|
无法访问 Windows Installer 服务。 |
|
将无效参数传递给函数。 |
|
该值已成功重新排序。 |
|
找不到修补程序。 |
|
找不到该产品。 |
|
意外的内部故障。 |
言论
管理员可以修改计算机上下文下或在其自己的每用户上下文(托管或非托管)下存在的产品或修补程序实例的安装。他们可以修改任何用户每用户托管上下文下存在的产品或修补程序实例的安装。 管理员无法修改其他用户安装在该用户的每用户非托管上下文下存在的产品或修补程序实例。
非管理员无法修改其他用户的每个用户上下文(托管或非托管)下存在的产品或修补程序实例的安装。他们可以修改在其自己的每用户非托管上下文下存在的产品或修补程序实例的安装。 仅当启用了产品或修补程序源浏览时,他们才能修改计算机上下文下的产品或修补程序实例的安装或自己的按用户管理的上下文。 用户可以通过设置策略来浏览源。 有关详细信息,请参阅 DisableBrowse、AllowLockdownBrowse、AllowLockDownMedia 和 AlwaysInstallElevated 策略。
注意
msi.h 标头将 MsiSourceListAddMediaDisk 定义为一个别名,该别名根据 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 |