Creates a cancelation point in the calling thread.

1 - C Binding

    #include <tis.h>

    void
    tis_testcancel (void);

2 - Arguments

    None

3 - Description

    This routine requests delivery of a pending cancelation request
    to the calling thread. Thus, this routine creates a cancelation
    point in the calling thread. The cancelation request is delivered
    only if a request is pending for the calling thread and the
    calling thread's cancelability state is enabled. (A thread
    disables delivery of cancelation requests to itself by calling
    tis_setcancelstate().)

    This routine, when called within very long loops, ensures that a
    pending cancelation request is noticed within a reasonable amount
    of time.

4 - Return Values

    None

5 - Associated Routines

       tis_setcancelstate()