IEnumReplItem::Next

The IEnumReplItem::Next method attempts to advance to the next item in the enumeration sequence.

Syntax

HRESULT Next(
unsigned long
celt,
HREPLITEM *
phItem,
unsigned long FAR *pCeltFetched,
);

At a Glance

Header file: Cesync.h
Platforms: H/PC
Windows CE versions: 222.0 and later

Parameters

celt
specifies the number of elements to return. If the number of elements requested is more than remains in the sequence, only the remaining elements are returned. The number of elements returned is passed through the pCeltFetched parameter (unless it is NULL).
phItem
points to the structure in which to return the elements.
pCeltFetched
points to the number of elements actually returned in *phItem. The pCeltFetched parameter cannot be NULL if celt is greater than one. Likewise, if pCeltFetched is NULL, celt must be one.

Return Values

S_OK
returned the requested number of elements, phItem is set if non-NULL. All requested entries are valid.
S_FALSE
returned fewer elements than requested in celt. In this case, unused slots in the enumeration are not set to NULL and *phItem holds the number of valid entries, even if zero is returned.
E_OUTOFMEMORY
out of memory.
E_INVALIDARG
the value of celt is invalid.
E_UNEXPECTED
an unexpected error occurred.