TELCallbackClear
Clears a callback request.
pascal TELErr TELCallbackClear (TELHandle hTEL, short callbackRef);
hTEL
- A handle to the telephone structure for the user's terminal. You get the handle from either the
TELNew or TELNewWithResult function.
callbackRef
- A value that identifies the callback request to be cleared. If you originated the callback request, set this parameter to the identifier returned by the
TELCallbackSet function (page 4-42) in its callbackRef parameter. If you are clearing a callback request made by a remote party, set it to the value of the mType parameter of the telCACallbackMsg message that has its value parameter set to telCallbackDesired.
- function result
- A result code.
DESCRIPTION
The TELCallbackClear function clears a callback request, regardless of whether the request originated at the local terminal or a remote terminal. To clear a locally-generated callback request, you must have previously set up the request with the TELCallbackSet function. To clear a remotely-generated callback request, your call appearance message handler will have previously received a telCACallbackMsg message with the value parameter set to telCallbackDesired.
