ITTAPI2::EnumeratePhones method (tapi3if.h)

The EnumeratePhones method enumerates the phone objects corresponding to the phone devices. If there are no phones available that can be used with the address, this method produces an empty enumeration and returns S_OK.

This method is intended for C/C++ applications. Visual Basic and scripting applications must use the get_Phones method.

Syntax

HRESULT EnumeratePhones(
  [out] IEnumPhone **ppEnumPhone
);

Parameters

[out] ppEnumPhone

Pointer to an IEnumPhone interface.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

TAPI calls the AddRef method on the IEnumPhone interface returned by ITTAPI2::EnumeratePhones. The application must call Release on the IEnumPhone 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

See also

IEnumPhone

ITTAPI2