ITAgentHandler::get_UsableAddresses method (tapi3.h)

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

Syntax

HRESULT get_UsableAddresses(
  [out] VARIANT *pVariant
);

Parameters

[out] pVariant

Pointer to VARIANT containing an ITCollection of ITAddress interface pointers (address objects).

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 pVariant parameter is not a valid pointer.

Remarks

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

Requirements

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

See also

EnumerateUsableAddresses

ITAddress

ITAgentHandler

ITCollection