ITTAPI2::get_Phones method (tapi3if.h)

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

See also

IEnumPhone

ITTAPI2