IEnumBackgroundCopyFiles::Next method

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

celt [in]

Number of elements requested.

rgelt [out]

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

pceltFetched [out]

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 10, version 1709 [desktop apps only]
Minimum supported server	Windows Server, version 1709 [desktop apps only]
Header	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Library	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IEnumBackgroundCopyFiles is defined as CA51E165-C365-424C-8D41-24AAA4FF3C40

See also

IEnumBackgroundCopyFiles