ITTAPI2::get_Phones method (tapi3if.h)

Article
02/22/2024

The get_Phones 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 collection and returns S_OK.

This method is intended for Visual Basic and scripting applications. C/C++ applications will find the EnumeratePhones method more convenient.

Syntax

HRESULT get_Phones(
  [out] VARIANT *pPhones
);

Parameters

[out] pPhones

Pointer to a VARIANT containing an ITCollection of ITPhone interface pointers.

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 ITPhone interface returned by ITTAPI2::get_Phones. The application must call Release on the ITPhone 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

Share via