Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method attempts to skip over the next celtelements 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 Skipfor collections in the Lines sample file Enumvar.cpp.

Copy Code
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

See Also

Reference

IEnumVARIANT