IEnumVARIANT::Skip (Compact 2013)

  • Article

3/26/2014

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

Header

oaidl.h,
oaidl.idl

Library

oleaut32.lib,
uuid.lib

See Also

Reference

IEnumVARIANT