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  //Address of output variable that receives 
                          // the IEnum<ELT_T> interface pointer
);
 

Parameter

ppenum
[out] Address of IEnum<ELT_T>* pointer variable that receives the interface pointer to the enumeration object. If the method is unsuccessful, the value of this output variable is undefined.

Return Values

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