IResultsFolder::AddIDList method

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

pidl [in]

Type: PCIDLIST_ABSOLUTE

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

ppidlAdded [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Show: