IEnum::Clone

HRESULT IEnum::Clone(ppenum)

Return another enumerator which contains exactly the same enumeration state as this one. Using this function, a client can remember a particular point in the enumeration sequence, then return to it at a later time. Notice that the enumerator returned is of the same actual interface as the one which is being cloned.

Caveats similar to the ones found in IEnum::Reset regarding enumerating the same sequence twice apply here as well.

Argument

Type

Description

ppenum

IEnum<ELT_T>**

The place in which to return the clone enumerator.


Return Value

Meaning

S_OK

Success. The enumeration was reset to its beginning.

E_UNEXPECTED

An unknown error occurred.