ITTAPI::EnumerateAddresses method (tapi3if.h)

The EnumerateAddresses method enumerates the addresses that are currently available. Provided for C and C++ applications. Automation client applications, such as those written in Visual Basic, must use the get_Addresses method.

Syntax

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parameters

[out] ppEnumAddress

Pointer to the IEnumAddress interface.

Return value

This method can return one of these values.

Remarks

An application typically uses this enumeration to check the capabilities of each address and determine which are useful for current purposes.

If an expected address is not found, this may indicate that the appropriate service provider has not been installed or is not working correctly.

TAPI calls the Addref method on the IEnumAddress interface returned by ITTAPI::EnumerateAddresses. The application must call the Release method on the IEnumAddress interface to free resources associated with it.

If an address is created or removed during a TAPI session, the application will be notified through the ITTAPIEventNotification interface. If an address has been created, such as by installing a Plug and Play device, the ITTAPIEventNotification::Event returns the TE_ADDRESSCREATE member of the TAPIOBJECT_EVENT enum. If an address is removed, ITTAPIEventNotification::Event returns TE_ADDRESSREMOVE. Calling EnumerateAddresses after these events will reflect the current addresses.

Requirements

See also

IEnumAddress

ITAddress

ITTAPI

Register Events code snippet

TAPI Object

get_Addresses