IEnumAgentHandler::Next method (tapi3.h)

The Next method gets the next specified number of elements in the enumeration sequence.

Syntax

HRESULT Next(
  [in]  ULONG          celt,
  [out] ITAgentHandler **ppElements,
  [out] ULONG          *pceltFetched
);

Parameters

[in] celt

Number of elements requested.

[out] ppElements

Pointer to ITAgentHandler interfaces.

[out] pceltFetched

Pointer to number of elements actually supplied. May be NULL if celt is one.

Return value

This method can return one of these values.

Value Meaning
S_OK
Method returned celt number of elements.
S_FALSE
Number of elements remaining was less than celt.
E_POINTER
The ppElements parameter is not a valid pointer.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.

Remarks

TAPI calls the AddRef method on the IEnumAgentHandler interface returned by IEnumAgentHandler::Next. The application must call Release on the IEnumAgentHandler interface to free resources associated with it.

Requirements

   
Target Platform Windows
Header tapi3.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

IEnumAgentHandler