IEnumIDList::Clone

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

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

HRESULT Clone(

IEnumIDList FAR * pEnumIDList,
IEnumIDList **ppenum
);

Returns the NOERROR value if successful or an OLE-defined error value otherwise.

Parmeters
pEnumIDList
Address of the IEnumIDList interface. In C++, this parameter is implicit.

ppenum
Address that receives a pointer to the new enumeration object. The calling application must eventually free the new object by calling its Release member function.

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