pthread_exc_get_status_np(3) Library Functions Manual pthread_exc_get_status_np(3)
NAME
pthread_exc_get_status_np - (Macro) Obtains a system-defined error status from a DECthreads status exception object.
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread_exception.h>
int pthread_exc_get_status_np(
EXCEPTION *exception,
unsigned long *code);
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
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
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
completion. The exception argument is not a valid DECthreads status exception object.
ERRORS
None
RELATED INFORMATION
Functions: pthread_exc_set_status_np(3)
Manuals: Guide to DECthreads and Programmer's Guide delim off
pthread_exc_get_status_np(3)