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