MsiSourceListGetInfoA 函数 (msi.h)

MsiSourceListGetInfo 函数检索特定上下文中产品或修补程序的源列表的相关信息。

语法

UINT MsiSourceListGetInfoA(
  [in]                LPCSTR            szProductCodeOrPatchCode,
  [in, optional]      LPCSTR            szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                DWORD             dwOptions,
  [in]                LPCSTR            szProperty,
  [out, optional]     LPSTR             szValue,
  [in, out, optional] LPDWORD           pcchValue
);

参数

[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 可以 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。
 
注意 不应使用特殊的 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] szProperty

一个以 null 结尾的字符串,指定要检索的属性值。 szProperty 参数可以是以下值之一。

名字 意义
INSTALLPROPERTY_MEDIAPACKAGEPATH
“MediaPackagePath”
相对于安装介质根目录的路径。
INSTALLPROPERTY_DISKPROMPT
“DiskPrompt”
提示用户安装媒体时使用的提示模板。
INSTALLPROPERTY_LASTUSEDSOURCE
“LastUsedSource”
产品最近使用的源位置。
INSTALLPROPERTY_LASTUSEDTYPE
“LastUsedType”
如果上次使用的源是网络位置,则为“n”。 如果上次使用的源是 URL 位置,则为“u”。 如果上次使用的源为媒体,则为“m”。 如果没有最后使用的源,则为空字符串(“”)。
INSTALLPROPERTY_PACKAGENAME
“PackageName”
源上的 Windows Installer 包或修补程序包的名称。

[out, optional] szValue

接收信息的输出缓冲区。 此缓冲区应足够大,足以包含信息。 如果缓冲区太小,则该函数将返回ERROR_MORE_DATA并将 *pcchValue 设置为值中 TCHAR 数,不包括终止 NULL 字符。

如果 szValue 设置为 NULL,并且 pcchValue 设置为有效指针,则该函数将返回ERROR_SUCCESS并将 *pcchValue 设置为值中 TCHAR 的数量,不包括终止 NULL 字符。 然后,可以再次调用该函数来检索值,szValue 缓冲区足够大,足以包含 *pcchValue + 1 个字符。

如果 szValuepcchValue 都设置为 NULL,则函数将返回ERROR_SUCCESS值(而不检索该值)。

[in, out, optional] pcchValue

指向一个变量的指针,该变量指定 szValue 缓冲区中 TCHAR 的数目。 当函数返回时,无论函数是否将值复制到指定的缓冲区,此参数都设置为所请求值的大小。 大小返回为请求值中 TCHAR 的数量,不包括终止 null 字符。

仅当 szValueNULL时,此参数才能设置为 NULL,否则该函数将返回ERROR_INVALID_PARAMETER。

返回值

MsiSourceListGetInfo 函数返回以下值。

价值 意义
ERROR_ACCESS_DENIED
用户无法读取指定的源列表。 这并不指示是找到产品还是修补程序。
ERROR_BAD_CONFIGURATION
配置数据已损坏。
ERROR_INVALID_PARAMETER
将无效参数传递给函数。
ERROR_MORE_DATA
提供的缓冲区不足以包含请求的数据。
ERROR_SUCCESS
已成功检索该属性。
ERROR_UNKNOWN_PATCH
找不到修补程序。
ERROR_UNKNOWN_PRODUCT
找不到该产品。
ERROR_UNKNOWN_PROPERTY
找不到源属性。
ERROR_FUNCTION_FAILED
意外的内部故障。

言论

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

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

注意

msi.h 标头将 MsiSourceListGetInfo 定义为一个别名,该别名根据 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

另请参阅

MsiSourceListSetInfo

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

ProductCode