Name

PEXDestroyStructures - Destroy Structures

Synopsis

void PEXDestroyStructures(Display ∗display, unsigned long count, PEXStructure ∗structures)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call. 

countThe number of structure resource identifiers. 

structuresAn array of resource identifiers of the structures to be destroyed. 

Returns

None

Description

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. 

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. 

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 PEXSearchNetwork or PEXUpdatePickMeasure function, a path error is generated.

Data Structures

typedef XID             PEXStructure;

Errors

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXCreateStructure, PEXGetStructuresInNetwork, PEXGetAncestors,
PEXGetDescendants, PEXChangeStructureRefs