ITAgentHandler::get_UsableAddresses method (tapi3cc.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 tapi3cc.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

EnumerateUsableAddresses

ITAddress

ITAgentHandler

ITCollection