ThbTapiCall.Deallocate
Unit: hbTapi
 

In TAPI a no longer needed (idle) call has to be dealocated to release internal resources. This does not affect the call state of the physical call. You normally don't have to call this procedure because it is called in ThbTapiCall.Destroy. Use the ThbTapiCall.Free procedure instead of Deallocate or let ThbTapiLine deallocate the call automatically (see ThbTapiLine.Options.AutoFreeIdleCalls).

Declaration

procedure Deallocate;

Remarks

Using this method causes the TAPI lineDeallocateCall function to be called. This function works in an asynchronous manner. See the chapter "The Synchronous / Asynchronous Model" and the ThbTapiLine.Options.SyncMode property to read more about the handling of asynchronous functions.

Errors

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

See Also

ThbTapiLine.Options.AutoFreeIdleCalls