通过

SHPropStgWriteMultiple 函数 (shlobj_core.h)

  • 项目

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

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

语法

SHSTDAPI SHPropStgWriteMultiple(
  [in]                IPropertyStorage  *pps,
  [in, out, optional] UINT              *puCodePage,
                      ULONG             cpspec,
  [in]                PROPSPEC const [] rgpspec,
  [in, out]           PROPVARIANT []    rgvar,
                      PROPID            propidNameFirst
);

参数

[in] pps

类型： IPropertyStorage*

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

[in, out, optional] puCodePage

类型： UINT*

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

cpspec

类型： ULONG

正在设置的属性计数。

[in] rgpspec

类型： PROPSPEC const[]

一个 PROPSPEC 结构的数组，其中包含要设置的属性信息。

[in, out] rgvar

类型： PROPVARIANT[]

用于设置属性值的 PROPVARIANT 类型的数组。

propidNameFirst

类型： PROPID

必须分配属性标识符时的最小值。 该值应大于或等于 PID_FIRST_USABLE。

返回值

类型： HRESULT

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

要求

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