NAME    [Toc]    [Back]

       pthread_exc_get_status_np  -  (Macro)  Obtains  a  systemdefined
 error status from a  DECthreads  status  exception
       object

SYNOPSIS    [Toc]    [Back]

       #include <pthread_exception.h>

       int pthread_exc_get_status_np(
               EXCEPTION *exception,
               unsigned long *code );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       DECthreads  status  exception  object whose status code is
       obtained.  Receives the system-specific status code  associated
  with  the  specified  DECthreads  status exception
       object.

DESCRIPTION    [Toc]    [Back]

       This routine obtains and returns the system-specific  status
  value  from  the  DECthreads  status exception object
       specified in the exception argument. This value must  have
       already  been  associated  with the exception object using
       the pthread_exc_set_status_np(3) routine.

       In a program that uses DECthreads status  exceptions,  use
       this  routine  within  a CATCH, CATCH_ALL, or FINALLY code
       block to obtain the status code value  associated  with  a
       caught  exception.  Note that any exception objects set to
       the same status value are considered  equivalent  by  DECthreads.

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value indicating the type of error.  If  the  routine's
  exception  object  argument is a DECthreads status
       exception, it sets the code argument and return zero  (0).
       Possible  return values are as follows: Successful completion.
  The exception argument is not  a  valid  DECthreads
       status exception object.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions: pthread_exc_set_status_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                     pthread_exc_get_status_np(3)