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