IEnumIDList::Clone method (shobjidl_core.h)

Creates a new item enumeration object with the same contents and state as the current one.

Syntax

HRESULT Clone(
  IEnumIDList **ppenum
);

Parameters

ppenum

Type: IEnumIDList**

The address of a pointer to the new enumeration object. The calling application must eventually free the new object by calling its Release member function.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM-defined error value otherwise.

Remarks

This method makes it possible to record a particular point in the enumeration sequence and then return to that point at a later time.

Requirements

See also

IEnumIDList