Edit

IEnumBackgroundCopyJobs1::Next method (qmgr.h)

  • Article

[IEnumBackgroundCopyJobs1 is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the BITS interfaces.]

Use the Next method to retrieve the specified number of items in the enumeration sequence. If there are fewer than the requested number of elements left in the sequence, it retrieves the remaining elements.

Syntax

HRESULT Next(
  [in]  ULONG celt,
  [out] GUID  *rgelt,
  [out] ULONG *pceltFetched
);

Parameters

[in] celt

Number of elements requested.

[out] rgelt

Array of GUIDs that identify the jobs. To retrieve a job, call the IBackgroundCopyGroup::GetJob method with the GUID.

[out] pceltFetched

Number of elements in rgelt. You can set pceltFetched to NULL if celt is one.

Return value

This method returns the following HRESULT values, as well as others.

Return code Description
S_OK
 Successfully returned the number of requested elements.
S_FALSE
 Returned less than the number of requested elements.

Requirements

Requirement Value
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Target Platform Windows
Header qmgr.h
DLL QmgrPrxy.dll

See also

IEnumBackgroundCopyJobs1