IEnumTfLatticeElements::Next method (ctffunc.h)

Obtains the specified number of elements in the enumeration sequence from the current position.

Syntax

HRESULT Next(
  [in]  ULONG            ulCount,
  [out] TF_LMLATTELEMENT *rgsElements,
  [out] ULONG            *pcFetched
);

Parameters

[in] ulCount

Specifies the number of elements to obtain.

[out] rgsElements

Pointer to an array of TF_LMLATTELEMENT structures that receives the requested data. This array must be at least ulCount elements in size.

The caller must free the bstrText member of every structure obtained using SysFreeString when it is no longer required.

[out] pcFetched

Pointer to a ULONG value that receives the number of elements actually obtained. This value can be less than the number of items requested. This parameter can be NULL.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
S_FALSE
The method reached the end of the enumeration before the specified number of elements could be obtained.
E_INVALIDARG
rgsElements is invalid.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ctffunc.h
DLL Sptip.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

IEnumTfLatticeElements

TF_LMLATTELEMENT