Вновь устанавливает перечислитель на начало последовательности.
HRESULT Reset();
Параметры:
Нет.
Коды возврата:
Из возвращенного HRESULT получают один из следующих кодов возврата:
| Код возврата | Значение |
|---|---|
| S_OK | Успех. |
| S_FALSE | Ошибка. |
Комментарии:
При повторном перечислении не гарантируется возврат той же самой последовательности вариантов, что и при первом. Хотя точное повторение и желательно, результат зависит от перечисляемого набора. Для некоторых наборов выполнение этого условия может оказаться непрактичным (например, в случае перечисления файлов в каталоге).
Пример:
Следующий код реализует IEnumVARIANT::Reset для наборов из примера Lines (файл Enumvar.cpp).
STDMETHODIMP CEnumVariant::Reset()
{
m_lCurrent = ra_lLBound;
return NOERROR;
}