IEnumVARIANT::Skip
A version of this page is also available for
4/8/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
| Header | oaidl.h, oaidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |