IEnumSpObjectTokens::Next (SAPI 5.4)

Microsoft Speech API 5.4

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.

  
    HRESULT Next(
   ULONG                                                             celt,
   [out, size_is(celt), length_is(*pceltFetched)] ISpObjectToken   **pelt,
   ULONG                                                            *pceltFetched
);

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
S_OK
E_POINTER
E_INVALIDARG
SPERR_UNINITIALIZED
S_FALSE
FAILED (hr)