SHPropStgReadMultiple 函数 (shlobj_core.h)

[此函数可通过 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 获得。 在后续版本的 Windows 中,它可能已更改或不可用。]

包装 IPropertyStorage::ReadMultiple 函数,以确保为弃用的属性集正确处理 ANSI 和 Unicode 转换。

语法

SHSTDAPI SHPropStgReadMultiple(
  [in]  IPropertyStorage  *pps,
        UINT              uCodePage,
        ULONG             cpspec,
  [in]  PROPSPEC const [] rgpspec,
  [out] PROPVARIANT []    rgvar
);

参数

[in] pps

类型: IPropertyStorage*

标识属性存储的 IPropertyStorage 接口指针。

uCodePage

类型: UINT

ANSI 字符串属性的代码页值。

cpspec

类型: ULONG

正在读取的属性计数。

[in] rgpspec

类型: PROPSPEC const[]

要读取的属性数组。

[out] rgvar

类型: PROPVARIANT[]

一个 PROPVARIANT 类型的数组,此函数成功返回时接收属性值。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
Library Shell32.lib
DLL Shell32.dll (版本 6.0 或更高版本)