ThbTapiLine.MakeCall (2)
Unit: hbTapi
 

This function is intended for the professional user, who needs to hand over more call paramerters than supported by ThbTapiLine.CallParams. Typically the simple variant of ThbTapiLine.MakeCall method is used.

The MakeCall function places a call on the line to the destination address specified in the DestAddr parameter.

Set the CountryCode to th country code of the called party. If a value of 0 is specified, a default is used by the implementation.The CallParams parameter allows the application to specify how it wants the call to be set up. This structure allows the application to select elements such as the call's bearer mode, data rate, expected media mode, origination address, blocking of caller ID information, and dialing parameters. We recommend to use the ThbTapiCallParams object to generate the needed LINECALLPARAMS structure. If NIL is specified, a default 3.1 kHz voice call is established and an arbitrary origination address on the line is selected.

Declaration

function MakeCall(DestAddr: String; CountryCode: DWORD; CallParams: PLINECALLPARAMS): ThbTapiCall;

Remarks

Please refer to the section "lineMakeCall" 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_ADDRESSBLOCKED, LINEERR_INVALLINEHANDLE, LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_DIALBILLING, LINEERR_INVALPARAM, LINEERR_DIALDIALTONE, LINEERR_INVALPOINTER, LINEERR_DIALPROMPT, LINEERR_INVALRATE, LINEERR_DIALQUIET, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_RATEUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALCALLPARAMS, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE, LINEERR_USERUSERINFOTOOBIG.

See Also

LINECALLPARAMS, ThbTapiCallParams