AFGetErrorText(3) AFGetErrorText(3) NAME AFSetErrorHandler, AFSetIOErrorHandler, AFGetErrorText, AFGetErrorData- baseText - error handlers SYNTAX #include <AF/AFlib.h> int (*AFSetErrorHandler) ((*handler)(AFAudioConn *aud, AFErrorEvent *event))() int (*AFSetIOErrorHandler) ((*handler)(AFAudioConn *aud))() void AFGetErrorText (AFAudioConn *aud, int code, char *buffer, int nbytes) void AFGetErrorDatabaseText (AFAudioConn *aud, char *name, char *type, char *defaultp, char *buffer, int nbytes) ARGUMENTS aud Specifies the connection to the audio server. buffer Returns the error description. code Specifies the error code for which a description is desired. defaultp Specifies the default error message if none is found in the data- base event Specifies the error event to the error handler. handler Specifies a new error handler. name Specifies the name of the application. nbytes Specifies the size of the buffer. type Specifies the type of the error message. DESCRIPTION AFlib usually calls the program's supplied error handler, if there is one, when an error is received. These errors are not assumed to be fatal, so it is safe for the handler to return. It must not, however, call any func- tions that generate protocol requests or read input events. The AFSetEr- rorHandler function supplies a new error handler, returning the previous one. The AFSetIOErrorHandler function sets a handler which is called when a sys- tem call fails. This is assumed to be a fatal condition, and the handler should not return. If it does, the client process exits. AFGetErrorText function copies a null-terminated string describing the specified error code into the given buffer. The AFGetErrorDatabaseText function returns a null-terminated message (or the default message) from the error message database. This error database is not currently implemented, and this routine always returns the default message. SEE ALSO AF(1) BUGS If you encounter a reproducible bug, please submit a problem report to (af-bugs@crl.dec.com). COPYRIGHT Copyright 1990-1994, Digital Equipment Corporation. See AF(1) for a full statement of rights and permissions. AUTHORS Digital Cambridge Research Lab