MsiSummaryInfoGetPropertyW 函数（msiquery.h）
MsiSummaryInfoGetProperty 函数从 摘要信息流获取单个属性。
语法
UINT MsiSummaryInfoGetPropertyW(
[in] MSIHANDLE hSummaryInfo,
[in] UINT uiProperty,
[out] PUINT puiDataType,
[out] LPINT piValue,
[out] FILETIME *pftValue,
[out] LPWSTR szValueBuf,
[in, out] LPDWORD pcchValueBuf
);
参数
[in] hSummaryInfo
摘要信息的句柄。
[in] uiProperty
指定摘要属性的属性 ID。 此参数可以是 摘要信息流属性集中列出的属性 ID。 此函数不返回 PID_DICTIONARY OR PID_THUMBNAIL 属性的值。
[out] puiDataType
接收返回的属性类型。 此参数可以是在
摘要信息流属性集。
[out] piValue
接收返回的整数属性数据。
[out] pftValue
指向文件值的指针。
[out] szValueBuf
指向接收 null 终止的摘要信息属性值的缓冲区的指针。 不要尝试通过传入 szValueBuf的 null（value=0）来确定缓冲区的大小。 可以通过传入空字符串来获取缓冲区的大小（例如“）。 然后，该函数返回ERROR_MORE_DATA，pcchValueBuf 包含 TCHAR中所需的缓冲区大小，不包括终止 null 字符。 返回ERROR_SUCCESS时，
[in, out] pcchValueBuf
指向指定变量 szValueBuf指向的缓冲区的大小 TCHAR的变量的指针。 函数返回ERROR_SUCCESS时，此变量包含复制到 szValueBuf的数据的大小，不包括终止 null 字符。 如果 szValueBuf 不够大，则该函数将返回ERROR_MORE_DATA并存储所需的大小（不包括终止 null 字符）pcchValueBuf指向的变量中。
返回值
MsiSummaryInfoGetProperty 函数返回以下值之一：
言论
如果返回ERROR_MORE_DATA，则为指针的参数提供保存字符串所需的缓冲区大小。 如果返回ERROR_SUCCESS，则它提供写入字符串缓冲区的字符数。 因此，可以通过传入指定缓冲区的参数的空字符串（例如“”）来获取缓冲区的大小。 不要尝试通过传入 Null（value=0）来确定缓冲区的大小。
不应使用 null 作为指针的值调用返回用户提供的内存位置中的数据的 Windows Installer 函数。 这些函数以整数指针的形式返回字符串或返回数据，但在将 null 作为输出参数的值传递时返回不一致值。 有关详细信息，请参阅 将 Null 作为 Windows Installer 函数的参数。
MsiSummaryInfoGetProperty 函数返回的属性信息由 piValue、pftValue或 szValueBuf 参数接收，具体取决于在 puiDataType 参数中指定的属性值的类型。
注意
msiquery.h 标头将 MsiSummaryInfoGetProperty 定义为一个别名，该别名根据 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 |
| 目标平台 | 窗户 |
| 标头 | msiquery.h |
| 库 | Msi.lib |
| DLL | Msi.dll |