Contents Index Topic Contents
	Previous Topic: IEnumWorkItems::Clone Next Topic: IEnumWorkItems::Reset

IEnumWorkItems::Next

HRESULT Next(
    ULONG celt, 
    LPWSTR ** rgpwszNames,
    ULONG * pceltFetched
);

Retrieves the next celt tasks in the enumeration sequence. If there are fewer than the requested number of elements left in the sequence, the remaining elements are retrieved.

• Returns one of the following values:

  S_OK	The number of tasks retrieved equals the number requested.
  S_FALSE	The number returned is less than the number requested (thus there are no more tasks to enumerate).
  E_INVALIDARG	A parameter is invalid.
  E_OUTOFMEMORY	Not enough memory is available.

celt

Number of tasks to retrieve.

rgpwszNames

Address of an array of pointers to character strings that contain the file names of the tasks returned from the enumeration sequence. These file names are taken from the Tasks folder and have the .job extension. You must free each LPWSTR in the array and the array itself using CoTaskMemFree.

pceltFetched

Address of a value that contains the number of tasks returned in rgpwszNames. If the celt parameter is 1, this parameter can be NULL.

Back to top

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.