IEnumXXXX::Clone

Creates another enumerator that contains the same enumeration state as the current one. Using this function, a client can record a particular point in the enumeration sequence, and then return to that point at a later time. The new enumerator supports the same interface as the original one.

HRESULT Clone(

IEnum<ELT_T> ** ppenum

//Indirect pointer to the enumeration interface on the object

);

Parameter

ppenum
[out] Indirect pointer to the enumeration interface on the enumeration object. If the method is unsuccessful, this parameter’s value is undefined.

Return Values

This method supports the standard return values E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED.