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
);

parameters

[in] szProductCodeOrPatchCode

产品或修补程序的 ProductCode 或修补程序 GUID。 使用以 null 结尾的字符串。 如果字符串长度超过 39 个字符,则函数将失败并返回ERROR_INVALID_PARAMETER。 此参数不能为 NULL

[in, optional] szUserSid

此参数可以是字符串 SID,用于指定包含产品或修补程序的用户帐户。 SID 未验证或解析。 错误的 SID 可能会返回ERROR_UNKNOWN_PRODUCT或ERROR_UNKNOWN_PATCH。

SID 的类型 含义
NULL
NULL 表示当前登录的用户。 引用当前用户帐户时, szUserSID 可以为 NULLdwContext 可以是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。 如果 dwContext 设置为仅MSIINSTALLCONTEXT_MACHINE, 则 szUserSid 必须为 NULL
 
注意 不应使用特殊 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 的含义。

标志 含义
MSICODE_PRODUCT
szProductCodeOrPatchCode 是一个产品代码 GUID。
MSICODE_PATCH
szProductCodeOrPatchCode 是修补程序代码 GUID。

[in] dwDiskId

此参数提供要添加或更新的磁盘的 ID。

[in] szVolumeLabel

szVolumeLabel 提供要添加或更新的磁盘的标签。 更新将覆盖注册表中的现有卷标签。 若要仅更改磁盘提示,请从注册表获取现有卷标签,并在此调用中提供它以及新的磁盘提示符。 为 szVolumeLabel 传递 NULL 或空字符串会将长度 (0 字节的空字符串注册为卷标签) 。

[in, optional] szDiskPrompt

在进入 MsiSourceListAddMediaDisk 时, szDiskPrompt 提供要添加或更新的磁盘的磁盘提示。 更新会覆盖已注册的磁盘提示符。
若要仅更改卷标签,请获取已注册的现有磁盘提示,并在调用 MsiSourceListAddMediaDisk 时提供该提示以及新的卷标签。 传递 NULL 或空字符串会将空字符串注册 (长度为 0 字节的空字符串,) 作为磁盘提示。

返回值

MsiSourceListAddMediaDisk 函数返回以下值。

含义
ERROR_ACCESS_DENIED
用户无法读取指定的媒体源或指定的产品或修补程序。 这并不指示是否已找到媒体源、产品或修补程序。
ERROR_BAD_CONFIGURATION
配置数据已损坏。
ERROR_INSTALL_SERVICE_FAILURE
无法访问 Windows Installer 服务。
ERROR_INVALID_PARAMETER
向该函数传递了无效参数。
ERROR_SUCCESS
已成功对值重新排序。
ERROR_UNKNOWN_PATCH
找不到修补程序。
ERROR_UNKNOWN_PRODUCT
找不到产品。
ERROR_FUNCTION_FAILED
意外的内部故障。

注解

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

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

注意

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 运行时要求。
目标平台 Windows
标头 msi.h
Library Msi.lib
DLL Msi.dll

另请参阅

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

ProductCode