IEnumIDList::Clone

[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.

See Also

IEnumIDList