Edit

Share via

IEnumLocation::Next method (tapi3if.h)

  • Article

The Next method gets the next specified number of elements in the enumeration sequence. This method is hidden from Visual Basic and scripting languages.

Syntax

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

Parameters

[in] celt

Number of elements requested.

[out] ppElements

Pointer to ITLocationInfo pointer.

[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.

Return code Description
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 ITLocationInfo interface returned by IEnumLocation::Next. The application must call Release on the ITLocationInfo interface to free resources associated with it.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll