IEnumDVD_XXXX::Next (Windows Embedded CE 6.0)

1/6/2010

This method retrieves a specified number of items in an enumeration sequence.

Syntax

HRESULT Next(
  ULONG celt,
  DVD_XXXX* rgelt,
  ULONG* pceltFetched
);

Parameters

• celt
  [in] Number of elements being requested.

• rgelt
  [out] Array of size celt (or larger) of the elements of interest.

  The type of this parameter depends on the item being enumerated and can be DVD_CELL_PIECE, DVD_TEXT_ITEM, or DVD_TEXT_LANGUAGE_UNIT.

• pceltFetched
  [in, out] Pointer to the number of elements actually supplied in rgelt. The caller can pass in NULL if celt is one.

Return Value

This method returns the following values.

Value	Description
S_OK	The number of elements supplied is celt.
S_FALSE	The number of elements supplied is not equal to celt.

Remarks

If the request number of elements is greater than the number of elements left in the collection then this method retrieves the remaining elements.

The number of elements actually retrieved is returned through pceltFetched (unless the caller passed in NULL for that parameter).

Requirements

Header	dvdata.h, dvdata.idl
Library	Ddvdids.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

IEnumDVD_XXXX
IEnumDVD_CELL_PIECE
IEnumDVD_TEXT_ITEM
IEnumDVD_TEXT_LANGUAGE_UNIT
DVD_CELL_PIECE
DVD_TEXT_ITEM
DVD_TEXT_LANGUAGE_UNIT