Purpose
Use Change Structure Identifier and References to change all execute structure-type elements which reference a structure (called the original structure) with elements which reference a specified structure (called the resulting structure). This subroutine changes the identifier of the original structure to be that of the resulting structure. The effect of this subroutine is as though the application called the Change Structure References subroutine followed by a call to the Change Structure Identifier subroutine.
If the original structure references the resulting structure, then the graPHIGS API generates an implementation error (-129) and no action occurs. This error is generated to prevent an application from causing recursive traversal of a structure.
Language Bindings
| pchange_struct_id_refs (orig_struct_id, result_struct_id) |
| PCSTIR (oldsid, newsid) |
Errors
Related Subroutines