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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 4.0 or later)

See also

IEnumIDList