Share via

IEnumSpObjectTokens::Next (Windows Embedded CE 6.0)

  • Article

1/6/2010

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.

Syntax

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 Value

The following table shows the possible return values.

Value Description

S_OK

Function completed successfully.

E_POINTER

One of the following errors was encountered:

  • pelt is bad or invalid,
  • pceltFetched is bad or invalid,
  • pceltFetched is bad and celt is more than one.

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

Header sapi.h, sapi.idl
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

IEnumSpObjectTokens
SAPI Interfaces