man3/AFGetErrorText.3

#

    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