IEnumBackgroundCopyFiles::Next method (bits.h)

Retrieves a 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] IBackgroundCopyFile **rgelt,
  [out] ULONG               *pceltFetched
);

Parameters

[in] celt

Number of elements requested.

[out] rgelt

Array of IBackgroundCopyFile objects. You must release each object in rgelt when done.

[out] pceltFetched

Number of elements returned in rgelt. You can set pceltFetched to NULL if celt is one. Otherwise, initialize the value of pceltFetched to 0 before calling this method.

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 bits.h
Library Bits.lib
DLL QmgrPrxy.dll

See also

IEnumBackgroundCopyFiles