3.1.3.2 Skip (Opnum 4)

  • Article

The Skip method is used to skip beyond the specified number of objects in the collection.

 HRESULT Skip(
   [in] ULONG celt
 );

celt: The number of elements to skip.

Return Values: The method MUST return the following error code for the specific condition.

Return value/code

Description

0x00000001

S_FALSE

Returned when the number of objects skipped is greater than the number of objects remaining in the list.

For any other conditions, the method MUST return zero when it has succeeded or an implementation-specific nonzero error code on failure.

No exceptions are thrown except those that are thrown by the underlying RPC protocol [MS-RPCE].

When the server receives this message, it MUST verify that celt is greater than zero.

The server MUST update an internal cursor variable so that a subsequent call to Next begins to retrieve objects that start immediately after the celt skipped objects.