IEnumWorkItems::Clone method (mstask.h)

[[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.] ]

Creates a new enumeration object that contains the same enumeration state as the current enumeration.

Because the new object points to the same place in the enumeration sequence, a client can use the Clone method to record a particular point in the enumeration sequence and return to that point later.

Syntax

HRESULT Clone(
  [out] IEnumWorkItems **ppEnumWorkItems
);

Parameters

[out] ppEnumWorkItems

A pointer to a pointer to a new IEnumWorkItems interface. This pointer will point to the newly created enumeration. If the method fails, this parameter is undefined.

Return value

Returns one of the following values.

Remarks

The IEnumWorkItems interface also provides methods for retrieving sets of tasks, skipping sets of tasks, and resetting the enumeration sequence.

Requirements

See also

IEnumWorkItems

IEnumWorkItems::Next

IEnumWorkItems::Reset

IEnumWorkItems::Skip