.\" @(#)PEXGetExtensionInfo.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetExtensionInfo 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetExtensionInfo - Get Extension Information
.SH SYNTAX
.HP
PEXExtensionInfo *PEXGetExtensionInfo\^(\^Display *\fIdisplay\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.SH RETURNS
.LP
A pointer to the extension information; a null pointer if unsuccessful.
.SH DESCRIPTION
.\" indexing
.IX PEXGetExtensionInfo
.LP
.B PEXGetExtensionInfo
allows an application program to inquire the extension
information from a PEX server extension.
.LP
The major version
number, minor version number, release number, vendor name, and subset
information are returned.  If the subset value is
.B PEXCompleteImplementation,
the extension is a full PEX implementation.
If the subset value is
.B PEXImmediateMode,
the extension supports only the 
.I immediate
.I rendering
subset of PEX.
If the subset value is
.B PEXStructureMode,
the extension supports only the
.I structure
.I rendering
subset of PEX.
If the subset value is (
.B PEXImmediateMode
and
.B PEXStructureMode
), the extension supports both the
.I immediate
.I rendering
and the
.I structure
.I rendering
subsets of PEX.
If the subset value is
.B PEXWorkstationOnly,
the extension supports only the
.I PHIGS
.I workstation
subset of PEX.
.LP
The memory returned by this function is private to PEXlib and must not be
modified or freed by the application.
.SH DATA STRUCTURES
.LP
.nf
typedef struct {
	unsigned short		major_version;
	unsigned short		minor_version;
	unsigned long		release;
	unsigned long		subset_info;
	char			*vendor_name;
	int			major_opcode;
	int			first_event;
	int			first_error;
.br
} PEXExtensionInfo;
.fi
.SH ERRORS
None