Name

pret_struct_nets − Retrieves a list of archived structure networks from an open archive file. 

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

Syntax

void pret_struct_nets (
  Pint              archive_id,   /∗ (I) Archive file identifier ∗/
  const Pint_list  ∗struct_ids    /∗ (I) List of structure identifiers ∗/
)

Data Structures

typedef struct {
    Pint      num_ints;  /∗ number of Pints in the list ∗/
    Pint     ∗ints;      /∗ list of integers ∗/
} Pint_list;

Description

pret_struct_nets retrieves the specified list of archived structure networks from the specified open archive file.  The value of the archive conflict resolution flag (MAINTAIN, ABANDON, or UPDATE) in the PHIGS state list determines how the function treats existing structures and structure descendants encountered in the specified archive file. 

See the structure archiving function pset_conf_res for information about setting conflict flags.  Use the pinq_conf_res and pinq_conf_structs_net functions in Inquiry Functions to return data about conflicts. 

See Also

par_struct_nets
pdel_struct_nets_ar
pinq_all_conf_structs
pinq_conf_res
pinq_conf_structs_net
popen_ar_file
pret_all_structs
pret_paths_ances
pret_paths_descs
pret_struct_ids
pret_structs
pset_conf_res