IEnumWorkItems::Skip method (mstask.h)

Article
02/22/2024

[[This API may be altered or unavailable in subsequent versions of the operating system or product. Please use the Task Scheduler 2.0 Interfaces instead.] ]

Skips the next specified number of tasks in the enumeration sequence.

Syntax

HRESULT Skip(
  [in] ULONG celt
);

Parameters

[in] celt

The number of tasks to be skipped.

Return value

Returns one of the following values.

Return code	Description
S_OK	The number of elements skipped equals celt.
S_FALSE	The number of elements remaining in the sequence is less than the value specified in celt.
E_INVALIDARG	The value of celt is less than or equal to zero.

Remarks

The IEnumWorkItems interface also provides methods for retrieving sets of tasks, resetting the enumeration sequence, and making a copy of the current state of the enumeration.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	mstask.h
Library	Mstask.lib
DLL	Mstask.dll
Redistributable	Internet Explorer 4.0 or later on Windows NT 4.0 and Windows 95