IEnumVARIANT::Skip

HRESULT Skip(
  unsigned long  celt  
);

Attempts to skip over the next celt elements in the enumeration sequence.

Parameter

celt: The number of elements to skip.

Return Value

The return value obtained from the returned HRESULT is one of the following:

Return value	Meaning
S_OK	The specified number of elements was skipped.
S_FALSE	The end of the sequence was reached before skipping the requested number of elements.

Example

The following code implements IEnumVariant::Skip for collections in the Lines sample file Enumvar.cpp.

STDMETHODIMP
CEnumVariant::Skip(ULONG cElements)
{
    m_lCurrent += cElements; 
    if (m_lCurrent > (long)(m_lLBound+m_cElements))
    {
        m_lCurrent =  m_lLBound+m_cElements;
        return ResultFromScode(S_FALSE);
    }
    else return NOERROR;
}