IEnumVARIANT::Skip Method

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

Copy 
HRESULT Skip( 
  unsigned long  celt  
);

celt

The number of elements to skip.

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.

The following code implements IEnumVariant::Skip. A complete example implementation of the IEnumVariant interface is available in the COM Fundamentals Lines sample (Enumvar.cpp).

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