[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
X11R6 Technical Reference

XESetWireToError Extension Function

Purpose

Defines a procedure to call whenever the XFreeFont function is called.

Library

AIXwindows Library (libX11.a)

C Syntax

Bool (*XESetWireToError(DisplayPtr, ErrorNumber, Procedure)()
Display *DisplayPtr
int ErrorNumber;
Bool (*Procedure)()

Description

This function defines a procedure to be called when an extension error needs to be converted from wire format to host format. The error number defines which protocol error code to install the conversion routine for. This procedure returns any previously defined procedure. Use this function for extension errors that contain additional error values beyond those in a core X error, or when it is necessary to intercept an X error before it is otherwise examined.

When the XFreeFont function is called, your program is called with these arguments:

(*Procedure)(Display, Re, Event)
Display *DisplayPtr;
XEvent *Re;
xEvent *Event;

The Re argument is a pointer to the host format event, and the Event argument is a pointer to where the 32-byte wire event structure should be stored. You should fill in the type with the type from the XEvent structure. All other members then should be copied from the host format to the xEvent structure.

Parameters

DisplayPtr Specifies the connection to the X server.
ErrorNumber Specifies the error code.
Procedure Specifies the routine to call when an error is received.

Return Values

Null Indicates that there is no previously defined procedure to be called when the XFreeFont function is called.
Procedure Indicates the name of a previously defined procedure to be called when the XFreeFont function is called.

Related Information

Using Extensions in AIXwindows in AIX Version 4.3 AIXwindows Programming Guide.

AIXwindows Overview for Programmers in AIX Version 4.3 AIXwindows Programming Guide.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]