IEnumVARIANT::Skip (Windows Embedded CE 6.0)

1/6/2010

This method attempts to skip over the next celt elements in the enumeration sequence.

Syntax

HRESULT Skip( 
  unsigned long celt 
);

Parameters

• celt
  [in] Number of elements to skip.

Return Value

If the specified number of elements was skipped, the return value is S_OK.

If the end of the sequence was reached before skipping the requested number of elements, the return value is S_FALSE.

Example

The following code implements 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;
}

Requirements

See Also

Reference

IEnumVARIANT