Name

pchange_struct_refs − Replaces structure elements referencing a structure with elements referencing another structure. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

void pchange_struct_refs (
  Pint   original_stid,    /∗ (I) Original structure identifier ∗/
  Pint   resulting_stid    /∗ (I) Resulting structure identifier ∗/
)

Description

pchange_struct_refs replaces structure elements that reference the specified original structure with elements that reference the specified resulting structure.  The function produces the following effects on the specified structures and the structures that reference them:

•References to the resulting structure identifier that existed before the call are not affected. 

•If references to the original structure identifier existed before the call, and the resulting structure identifier does not exist at the time of the call, an empty structure (named with the resulting structure identifier) is created. 

•If the original structure identifier and the resulting structure identifier are identical, no action is taken. 

•On all workstations where both the resulting structure and the original structure are posted, the resulting structure remains posted with an unchanged priority. The original structure is unposted. 

•On all workstations where the resulting structure is not posted and the original structure is posted, the resulting structure is posted with the priority of the original structure.  The original structure is unposted. 

•If the original structure does not exist at the time of the call, or if there are no references to the original structure identifier, no action is taken. 

See Also

pchange_struct_id
pchange_struct_id_refs
pexec_struct
pinq_posted_structs
ppost_struct