IEnumVARIANT::Skip

  • Article

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

HRESULT Skip( 
  unsigned long celt 
);

Parameters

  • celt
    [in] Number of elements to skip.

Return Values

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

OS Versions: Windows CE 2.0 and later.
Header: Oaidl.h, Oaidl.idl.
Link Library: Oleaut32.lib, Uuid.lib.

See Also

IEnumVARIANT

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.