IResultsFolder::AddIDList method (shobjidl.h)

Inserts a pointer to an item identifier list (PIDL) into a results folder.

Syntax

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

Parameters

[in] pidl

Type: PCIDLIST_ABSOLUTE

A pointer to the IDList of the given object relative to the Desktop.

[out] ppidlAdded

Type: PITEMID_CHILD*

A PIDL consisting of 0 or 1 SHITEMID structures, relative to a parent folder. This parameter maybe NULL.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The PIDL received represents the item that was just added and is a unique representation of this item generated by this results folder. It is only valid when used in reference to this results folder and should not be combined with a PIDL to another folder, including the folder this item originally came from.

Requirements