IEnumSpObjectTokens::Next (Windows CE 5.0)
This method gets the requested number of object tokens that remain 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, ISpObjectToken** pelt, ULONG* pceltFetched);
Parameters
- celt
[in] Number of object tokens to retrieve. - pelt
[out] Address of a pointer to an array of objects implementing ISpObjectToken. If an error code is returned by the method, no entries in the array are valid. - pceltFetched
[out] Pointer to the number of ISpObjectToken objects actually copied to the array. This parameter cannot be NULL if celt is more than one. If this parameter is NULL, celt must be one.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_POINTER | One of the following errors was encountered:
|
| E_INVALIDARG | celt is zero. |
| SPERR_UNINITIALIZED | Attribute parser interface is not initialized. |
| S_FALSE | celt is more than the number of objects available. |
| FAILED(hr) | Appropriate error message. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: sapi.h, sapi.idl.
Link Library: Sapilib.lib.
See Also
IEnumSpObjectTokens | SAPI Interfaces
Send Feedback on this topic to the authors