IEnumVARIANT FAR* FAR* ppenum
Creates a copy of the current enumeration state.
On return, pointer to the location of the clone enumerator.
The SCODE obtained from the returned HRESULT is one of the following:
||Insufficient memory to complete the operation.
Using this function, you can record a particular point in the enumeration
sequence, then return to it at a later time. The enumerator returned is of the same
actual interface as the one that is being cloned.
There is no guarantee that exactly the same set of variants will be enumerated
the second time as was enumerated the first. Although an exact duplicate is
desirable, the outcome depends on the collection being enumerated. Some
collections (for example, an enumeration of the files in a directory) will find it
impractical to maintain this condition.
The following code implements IEnumVariant::Clone
for collections in the Lines sample (ENUMVAR.CPP):
CEnumVariant::Clone(IEnumVARIANT FAR* FAR* ppenum)
CEnumVariant FAR* penum = NULL;
hr = CEnumVariant::Create(m_psa, m_cElements, &penum);
penum->m_lCurrent = m_lCurrent;
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages