.\" @(#)PEXChangeStructureRefs.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXChangeStructureRefs 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXChangeStructureRefs \- Change Structure References
.SH SYNTAX
.HP
void PEXChangeStructureRefs\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIold_structure\fP\^, PEXStructure \fInew_structure\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIold_structure\fP
The resource identifier of the structure no longer to be referenced.
.TP
\fInew_structure\fP
The resource identifier of the structure now referenced.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXChangeStructureRefs
.IX "Structure Elements" PEXChangeStructureRefs
.LP
This function changes execute structure elements in the server that
reference the specified old structure into
execute structure elements which reference the specified new structure.
Both structures must already exist as valid structure resources.
.LP
Any references to the new structure that existed before this
request are not affected.  If there were references to the old structure
and the new structure does not exist, an error is returned
and no action is taken.
.LP
On all PHIGS workstation resources where the new structure is not
already posted and the old structure is posted, the new structure is posted
with the same priority as the old structure and the old structure is unposted.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.sp
.fi
.SH ERRORS
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateStructure (3)
.BR PEXGetStructureInfo (3)
.BR PEXGetStructuresInNetwork (3)
.BR PEXGetAncestors (3)
.BR PEXGetDescendants (3)
.fi