LPC Library Functions: remove_call_out

NAME

remove_call_out() - remove a pending call_out

SYNOPSIS

int remove_call_out( string fun );

int remove_call_out( int handle );

int remove_call_out();

DESCRIPTION

In the first form, remove_call_out() removes the next pending call out for the function `fun' in the current object. The return value is the time remaining before the callback was to be called. The returned value is -1 if there was no call out pending for this function.

The second form is available only if the driver flag CALL_OUT_HANDLES is defined. In the second form, remove_call_out() removes the call out specified by 'handle'. 'handle' is the call out handle returned from the original execution of call_out().

The third form removes all of the call outs for this_object().

SEE ALSO

call_out(), call_out_info().