This procedure prepares the call for the addition of another party. The call must be a conference call in the connected state and the application must be the owner of this call. A consultation call is returned when the function succeeds, otherwise an EhbTapiError exception will raise. The consultation call will be established on the same address as the initiating call. The MediaMode, BearerMode and BlockID params will be taken from the ThbTapiLine.CallOptions property.

When the called party has answered the call and the state has turned to LINECALLSTATE_CONNECTED, the ThbTapiCall.AddToConference function is used add the consultation call to the conference.

If you need more call parameters as supported by ThbTapiLine.CallOptions, we recommend to use the ThbTapiLine.PrepareAddToConference method.

Declaration

function PrepareAddToConference: ThbTapiCall;

Remarks

Please refer to the section "linePrepareAddToConference" in TAPI's documentation for a more detailed information. This function works in an asynchronous manner. See the SyncMode property to read more about the handling of asynchronous functions.

Errors

Using this function may cause an EhbTapiError exception. Possible errors are:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

See Also

Establish a Conference Call