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.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.