.\" @(#)PEXDestroyStructures.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXDestroyStructures 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXDestroyStructures \- Destroy Structures
.SH SYNTAX
.HP
void PEXDestroyStructures\^(\^Display *\fIdisplay\fP\^, unsigned long \fIcount\fP\^, PEXStructure *\fIstructures\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIcount\fP
The number of structure resource identifiers.
.TP
\fIstructures\fP
An array of resource identifiers of the structures to be destroyed.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXDestroyStructures
.LP
This function deletes each structure in the list of structure identifiers,
removes all references to it in the server, and
frees all memory associated with it.
.LP
This function also removes any "execute structure" structure elements
that reference a structure in the list and unposts any structure in
the list from a PHIGS workstation resource to which it is posted.
If a structure has any structure elements removed from it as a result
of this call, its element pointer will continue to point at the same
structure element.  However, if the structure element being pointed
at is removed, the element pointer will be positioned at the previous
structure element.
.LP
Any paths in search contexts or pick measures that contain references
to a deleted structure may still be inquired.
However, if a path in a search context or pick measure resource which
contains a destroyed structure resource identifier is later used in a
.BR PEXSearchNetwork (3)
or
.BR PEXUpdatePickMeasure (3)
function, a path error is generated.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.fi
.sp
.SH ERRORS
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateStructure (3)
.BR PEXGetStructuresInNetwork (3)
.BR PEXGetAncestors (3)
.BR PEXGetDescendants (3)
.BR PEXChangeStructureRefs (3)
.fi