pthread_exc_get_status_np(3)pthread_exc_get_status_np(3)NAMEpthread_exc_get_status_np - (Macro) Obtains a system-defined error sta‐
tus from a DECthreads status exception object
SYNOPSIS
#include <pthread_exception.h>
int pthread_exc_get_status_np(
EXCEPTION *exception,
unsigned long *code );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
STANDARDS
None
PARAMETERS
DECthreads status exception object whose status code is obtained.
Receives the system-specific status code associated with the specified
DECthreads status exception object.
DESCRIPTION
This routine obtains and returns the system-specific status value from
the DECthreads status exception object specified in the exception argu‐
ment. 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 DEC‐
threads.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error. If the routine's exception object argu‐
ment is a DECthreads status exception, it sets the code argument and
return zero (0). Possible return values are as follows: Successful com‐
pletion. The exception argument is not a valid DECthreads status
exception object.
ERRORS
None
SEE ALSO
Functions: pthread_exc_set_status_np(3)
Manuals: Guide to DECthreads and Programmer's Guide
pthread_exc_get_status_np(3)