Пытается получить следующие celt элементов последовательности перечисления и возвращает их в массиве, на который указывает rgvar.
HRESULT Next ( unsigned long celt, VARIANT FAR* rgvar, unsigned long FAR* pceltFetched );
Параметры:
Коды возврата:
Из возвращенного HRESULT получают один из следующих кодов возврата:
Код возврата | Значение |
---|---|
S_OK | Число возвращенных элементов равно celt. |
S_FALSE | Число возвращенных элементов меньше celt. |
Комментарии:
Если число оставшихся элементов меньше запрошенного, Next возвращает только оставшиеся элементы. Фактическое число элементов передается через *pCeltFetched, если этот параметр не равен NULL.
Пример:
Следующий код реализует IEnumVARIANT::Next для наборов из примера Lines (файл Enumvar.cpp).
STDMETHODIMP CEnumVariant::Next(ULONG cElements, VARIANT FAR* pvar, ULONG FAR* pcElementFetched) { HRESULT hr; ULONG l; long l1; ULONG l2; if (pcElementFetched != NULL) *pcElementFetched = 0; for (l=0; l< cElements; l++) Variantlnit(&pvar[l]); // Получить следующие cElements элементов. for (l1=m_lCurrent, l2=0; l1<(long)(m_lLBound+m_cElements) && l2<cElements; l1++, l2++) { hr = SafeArrayGetElement(m_psa, &l1, &pvar[l2]); if (FAILED(hr)) goto error; }; // Возвратить число полученных элементов. if (pcElementFetched != NULL) *pcElementFetched = l2; m_lCurrent = l1; return (l2 < cElements) ? ResultFromScode(S_FALSE) : NOERROR; error: for (l=0; l<cElements; l++) VariantClear(&pvar[l]); return hr; };