IFileOperation::ApplyPropertiesToItems 方法 (shobjidl_core.h)
声明一组要为其应用一组通用属性值的项。
语法
HRESULT ApplyPropertiesToItems(
[in] IUnknown *punkItems
);
参数
[in] punkItems
类型: IUnknown*
指向表示项组的 IShellItemArray、IDataObject 或 IEnumShellItems 对象的 IUnknown 的指针。 还可以指向 IPersistIDList 对象来表示单个项,从而有效地完成与 IFileOperation::ApplyPropertiesToItem 相同的函数。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
此方法不将属性应用于项,而只是声明项。 若要在一组项上设置属性值,必须至少进行此处详述的调用序列:
- 调用 IFileOperation::SetProperties 以声明要设置的特定属性及其新值。
- 调用 IFileOperation::ApplyPropertiesToItems 来声明要设置其属性值的项。
- 调用 IFileOperation::P erformOperations 将属性应用于项。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |