MsiSourceListEnumMediaDisksA 函数 （msi.h）
MsiSourceListEnumMediaDisks 函数枚举为修补程序或产品的媒体源注册的磁盘列表。
语法
UINT MsiSourceListEnumMediaDisksA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwIndex,
[out, optional] LPDWORD pdwDiskId,
[out, optional] LPSTR szVolumeLabel,
[in, out, optional] LPDWORD pcchVolumeLabel,
[out, optional] LPSTR szDiskPrompt,
[in, out, optional] LPDWORD pcchDiskPrompt
);
参数
[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的含义。
| 旗 | 意义 |
|---|---|
|
szProductCodeOrPatchCode 是一个代码示例 GUID。 |
|
szProductCodeOrPatchCode 是修补程序代码 GUID。 |
[in] dwIndex
要检索的源的索引。 对于对 MsiSourceListEnumMediaDisks 函数的第一次调用，此参数必须为 0（零），然后递增以供后续调用，直到函数返回ERROR_NO_MORE_ITEMS。
[out, optional] pdwDiskId
在 MsiSourceListEnumMediaDisks 的条目 此参数提供指向 DWORD 的指针，以接收正在枚举的磁盘的 ID。 此参数是可选的。
[out, optional] szVolumeLabel
接收正在枚举的磁盘的卷标签的输出缓冲区。 此缓冲区应足够大，足以包含信息。 如果缓冲区太小，则该函数将返回ERROR_MORE_DATA并将 *pcchVolumeLabel 设置为值中 TCHAR 数，不包括终止 NULL 字符。
如果 szVolumeLabel 和 pcchVolumeLabel 都设置为 NULL，则该函数将返回ERROR_SUCCESS值（而不检索该值）。
[in, out, optional] pcchVolumeLabel
指向一个变量的指针，该变量指定 szVolumeLabel 缓冲区中 TCHAR 的数目。 函数返回时，此参数是接收值中 TCHAR 数，不包括终止 null 字符。
仅当 szVolumeLabel 也 NULL时，此参数才能设置为 NULL，否则该函数将返回ERROR_INVALID_PARAMETER。
[out, optional] szDiskPrompt
接收正在枚举的磁盘的磁盘提示的输出缓冲区。 此缓冲区应足够大，足以包含信息。 如果缓冲区太小，则该函数将返回ERROR_MORE_DATA并将 *pcchDiskPrompt 设置为值中 TCHAR 数，不包括终止 NULL 字符。
如果将 szDiskPrompt 设置为 NULL，并且 pcchDiskPrompt 设置为有效指针，则该函数将返回ERROR_SUCCESS并将 *pcchDiskPrompt 设置为值中 TCHAR 数，不包括终止 NULL 字符。 然后，可以再次调用该函数以检索值，szDiskPrompt 缓冲区足够大，足以包含 *pcchDiskPrompt + 1 个字符。
如果 szDiskPrompt 和 pcchDiskPrompt 都设置为 NULL，则函数将返回ERROR_SUCCESS值（而不检索该值）。
[in, out, optional] pcchDiskPrompt
指向一个变量的指针，该变量指定 szDiskPrompt 缓冲区中 TCHAR 的数目。 当函数返回时，无论函数是否将值复制到指定的缓冲区，此参数都设置为所请求值的大小。 大小返回为请求值中 TCHAR 的数量，不包括终止 null 字符。
仅当 szDiskPrompt 也 NULL时，此参数才能设置为 NULL，否则该函数将返回ERROR_INVALID_PARAMETER。
返回值
MsiSourceListEnumMediaDisks 函数返回以下值。
| 价值 | 意义 |
|---|---|
|
用户无法读取指定的媒体源或指定的产品或修补程序。 这并不指示是否找到媒体源、产品或修补程序。 |
|
配置数据已损坏。 |
|
将无效参数传递给函数。 |
|
不再注册此产品或修补程序的磁盘。 |
|
已成功枚举该值。 |
|
找不到修补程序。 |
|
找不到该产品。 |
|
提供的缓冲区太小，无法包含请求的信息。 |
|
意外的内部故障。 |
言论
对 MsiSourceListEnumMediaDisks 进行多次调用 以枚举单个产品实例的所有源时，必须从同一线程发出每个调用。
管理员可以为任何用户枚举每用户非托管和托管安装、每台计算机安装和每用户托管安装。 管理员无法为其他用户枚举每用户非托管安装。 非管理员只能枚举自己的每用户非托管安装和托管安装和每台计算机安装。
注意
msi.h 标头将 MsiSourceListEnumMediaDisk 定义为一个别名，该别名根据 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 |