Share via


Note

Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

Microsoft Speech Platform

IEnumSpObjectTokens::Next

IEnumSpObjectTokens::Next retrieves the next object token in the enumeration sequence.

If there are fewer than the requested number of elements left in the sequence, the remaining elements are retrieved.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>HRESULT Next(</strong> <strong> ULONG</strong> <em>celt</em>, <strong>[out, size_is(celt), length_is(*pceltFetched)] </strong><a runat="server" href="jj127672(v=msdn.10).md"><strong>ISpObjectToken</strong></a> **<em>pelt</em>, <strong> ULONG</strong> *<em>pceltFetched</em> <strong>);</strong> </pre>

Parameters

  • celt
    [in] The number of object tokens to retrieve.
  • pelt
    [out] Address of an array that receives ISpObjectToken pointers. If an error value is returned, no entries in the array are valid.
  • pceltFetched
    [out] Address of a variable that receives the number of ISpObjectToken pointers actually copied to the array. This parameter cannot be NULL if celt is greater than one. If this parameter is NULL, celt must be one.

Return Values

Value Description
S_OK Function completed successfully.
E_POINTER One of the following errors was encountered:
pelt is bad or not valid,
pceltFetched is bad or not valid,
pceltFetched is bad and celt is greater than one.
E_INVALIDARG celt is zero.
SPERR_UNINITIALIZED Attribute parser interface is not initialized.
S_FALSE celt is greater than the number of objects available.
FAILED (hr) Appropriate error message.