通过

MsiSourceListEnumSourcesW 函数 （msi.h）

  • 项目

MsiSourceListEnumSources 函数枚举指定修补程序或产品的源列表中的源。

语法

UINT MsiSourceListEnumSourcesW(
  [in]                LPCWSTR           szProductCodeOrPatchCode,
  [in, optional]      LPCWSTR           szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                DWORD             dwOptions,
  [in]                DWORD             dwIndex,
  [in, optional]      LPWSTR            szSource,
  [in, out, optional] LPDWORD           pcchSource
);

参数

[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。

SID 的类型 意义
NULL
 NULL 指示登录的当前用户。 引用当前用户帐户时，szUserSID 可以 NULL，dwContext 可以MSIINSTALLCONTEXT_USERMANAGED或MSIINSTALLCONTEXT_USERUNMANAGED。
用户 SID
 系统中特定用户的枚举。 用户 SID 的示例是“S-1-3-64-2415071341-1358098788-3127455600-2561”。
s-1-1-0
 特殊的 SID 字符串 s-1-1-0（每个人）指定系统中所有用户的枚举。
 
注意 特殊 SID 字符串 s-1-5-18 （系统）不能用于按计算机枚举安装的产品或修补程序。 将 SID 值设置为 s-1-5-18 将返回ERROR_INVALID_PARAMETER。
 

[in] dwContext

产品或修补程序实例的上下文。 此参数可以包含以下值之一。

上下文类型 意义
MSIINSTALLCONTEXT_USERMANAGED
 产品或修补程序实例存在于每个用户管理的上下文中。
MSIINSTALLCONTEXT_USERUNMANAGED
 产品或修补程序实例存在于每用户非托管上下文中。
MSIINSTALLCONTEXT_MACHINE
 产品或修补程序实例存在于每台计算机上下文中。

[in] dwOptions

dwOptions 值确定 szProductCodeOrPatchCode 值的解释以及要清除的源类型。 此参数必须是下列MSISOURCETYPE_* 常量之一和下列MSICODE_* 常量之一的组合。

旗 意义
MSISOURCETYPE_NETWORK
 源是网络类型。
MSISOURCETYPE_URL
 源是 URL 类型。
MSICODE_PRODUCT
 szProductCodeOrPatchCode 是一个代码示例。
MSICODE_PATCH
 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 函数返回以下值。

价值 意义
ERROR_ACCESS_DENIED
 用户无法读取指定的源列表。 这并不指示是找到产品还是修补程序。
ERROR_BAD_CONFIGURATION
 配置数据已损坏。
ERROR_INVALID_PARAMETER
 将无效参数传递给函数。
ERROR_MORE_DATA
 提供的缓冲区不足以包含请求的数据。
ERROR_NO_MORE_ITEMS
 指定列表中没有更多要枚举的源。
ERROR_SUCCESS
 已成功枚举源。
ERROR_UNKNOWN_PATCH
 指定的修补程序未安装在指定上下文中的计算机上。
ERROR_UNKNOWN_PRODUCT
 指定的产品未安装在指定上下文中的计算机上。
ERROR_FUNCTION_FAILED
 意外的内部故障。

言论

对 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 Run-Time 要求。
目标平台 窗户
标头 msi.h
库 Msi.lib
DLL Msi.dll

另请参阅

安装上下文

Windows Installer 2.0 及更早版本中不支持

ProductCode