Создает копию текущего состояния перечислителя.
HRESULT Clone ( lEnumVARIANT FAR* FAR*ppEnum );
Параметр:
Коды возврата:
Из возвращенного HRESULT получают один из следующих кодов возврата:
Код возврата | Значение |
---|---|
S_OK | Успех. |
E_OUTOFMEMORY | He хватает памяти для выполнения операции. |
Комментарии:
С помощью этой функции можно запомнить некоторую точку в последовательности перечисления, чтобы позднее к ней возвратиться. Полученный перечислитель имеет тот же интерфейс, что и оригинальный. При повторном перечислении не гарантируется возврат той же самой последовательности вариантов, что при первом. Хотя точное повторение и желательно, результат зависит от перечисляемого набора. Для некоторых наборов выполнение этого условия может оказаться непрактичным (например, в случае перечисления файлов в каталоге).
Пример:
Следующий код реализует IEnumVARIANT::Clone для наборов из примера Lines (файл Enumvar.cpp).
STDMETHODIMP CEnumVariant::Clone(IEnumVARIANT FAR* FAR* ppenum) { CEnumVariant FAR* penum = NULL; HRESULT hr; *ppenum = NULL; hr = CEnumVariant::Create(m_psa, m_cElements, &penum); if (FAILED(hr)) goto error; penum->AddRef(); penum->m_lCurrent = m_lCurrent; *ppenum = penum; return NOERROR; error: if (penum) penum->Release(); return hr; }