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