Content-type: text/html Man page of pthread_exc_get_status_np

pthread_exc_get_status_np

Section: C Library Functions (3)
Index Return to Main Contents
 

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 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

None  

RELATED INFORMATION

Functions: pthread_exc_set_status_np(3)

Manuals: Guide to DECthreads and Programmer's Guide delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:01 GMT, October 02, 2010