Partager via


IEnumDVD_XXXX::Next

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

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 Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Dvdata.h, Dvdata.idl.
Link Library: Ddvdids.lib.

See Also

IEnumDVD_XXXX | IEnumDVD_CELL_PIECE | IEnumDVD_TEXT_ITEM | IEnumDVD_TEXT_LANGUAGE_UNIT | DVD_CELL_PIECE | DVD_TEXT_ITEM | DVD_TEXT_LANGUAGE_UNIT

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.