The Drop method drops or disconnects the specified call. The UserUserInfo can be used to specify user-user information to be transmitted as part of the call disconnect. The call typically moves into the idle call state and will be automatically deallocated after a time delay defined inf the ThbTapiLine.Options.AutoFreeIdleCalls property.

Declaration

procedure Drop(UserUserInfo: String = '');

Description

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

Errors

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED.