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