IFileOperation：：ApplyPropertiesToItems 方法 (shobjidl_core.h)

  • 项目

声明一组要为其应用一组通用属性值的项。

语法

HRESULT ApplyPropertiesToItems(
  [in] IUnknown *punkItems
);

参数

[in] punkItems

类型： IUnknown*

指向表示项组的 IShellItemArray、IDataObject 或 IEnumShellItems 对象的 IUnknown 的指针。 还可以指向 IPersistIDList 对象来表示单个项，从而有效地完成与 IFileOperation：：ApplyPropertiesToItem 相同的函数。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此方法不将属性应用于项，而只是声明项。 若要在一组项上设置属性值，必须至少进行此处详述的调用序列：

  1. 调用 IFileOperation：：SetProperties 以声明要设置的特定属性及其新值。
  2. 调用 IFileOperation：：ApplyPropertiesToItems 来声明要设置其属性值的项。
  3. 调用 IFileOperation：:P erformOperations 将属性应用于项。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

IFileOperation

IFileOperation：：ApplyPropertiesToItem