IResultsFolder：：AddIDList 方法 (shobjidl.h)

将指向项标识符列表的指针 (PIDL) 插入到结果文件夹中。

语法

HRESULT AddIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] PITEMID_CHILD     *ppidlAdded
);

[in] pidl

类型： PCIDLIST_ABSOLUTE

指向给定对象相对于桌面的 IDList 的指针。

[out] ppidlAdded

类型： PITEMID_CHILD*

相对于父文件夹，由 0 或 1 个 SHITEMID 结构组成的 PIDL。此参数可能 为 NULL。

类型： HRESULT

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

收到的 PIDL 表示刚添加的项，是此结果文件夹生成的此项的唯一表示形式。它仅在引用此结果文件夹时有效，不应与 PIDL 组合到另一个文件夹，包括此项目最初来自的文件夹。