AFGetErrorText(3)

NAME
AFSetErrorHandler, AFSetIOErrorHandler, AFGetErrorText, AFGetErrorDatabaseText - 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 database

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 functions that generate protocol requests or read input events. The function supplies a new error handler, returning the previous one.

The function sets a handler which is called when a system call fails. This is assumed to be a fatal condition, and the handler should not return. If it does, the client process exits.

function copies a null-terminated string describing the specified error code into the given buffer.

The 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