ITAgentHandler::EnumerateUsableAddresses method (tapi3cc.h)

The EnumerateUsableAddresses method enumerates addresses available for receiving ACD calls on this agent handler. This method is provided for C and C++ applications. Automation client applications, such as those written in Visual Basic, must use the get_UsableAddresses method.

Syntax

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

Parameters

[out] ppEnumAddress

Pointer to IEnumAddress interface.

Return value

This method can return one of these values.

Value Meaning
S_OK
Method succeeded.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
E_POINTER
The ppEnumAddress parameter is not a valid pointer.

Remarks

TAPI calls the AddRef method on the IEnumAddress interface returned by ITAgentHandler::EnumerateUsableAddresses. The application must call Release on the IEnumAddress interface to free resources associated with it.

Requirements

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

See also

ITAgentHandler