NAME

INQUIRE ALL CONFLICTING STRUCTURES − inquire all conflicting structures in the Central Structure Store and an archive file

SYNOPSIS

C Syntax

void
pinq_all_conf_structs ( ar_id, length, start, error_ind, ids, total_length )
Pintar_id;archive identifier
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint_list∗ids;OUT list of conflicting structure ids
Pint∗total_length;OUT length of list in PHIGS

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

INQUIRE ALL CONFLICTING STRUCTURES obtains a list of the identifiers of all structures which exist in both the Central Structure Store and the specified open archive file. 

C Input Parameters

ar_idThe archive identifier specifying the open archive file to use. 

lengthThe number of ints items in the ids output parameter for which the application has allocated memory.  length is the number of list elements (structure identifiers) that the system can return in ints.  If a value of 0 is used here, no data will be returned in the ints list, but the total number of conflicting structures will be returned in total_length. 

startStarting position in the list of identifiers of conflicting structures at which to begin the inquiry.  The elements of the list of structure identifiers, beginning with the item number specified by start, are copied sequentially into ints until ints is full or all the structure identifiers have been copied. 

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

idsA pointer to a Pint_list structure in which the list of identifiers of conflicting structures is returned.  The Pint_list structure is defined in phigs.h as follows:

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

The num_ints component specifies the number of structure identifiers in the list. The ints component is a pointer to a list, num_ints long, of the structure identifiers.  The application must allocate memory for length elements in the ints list. 

total_length
A pointer to an integer in which the total number of conflicting structures is returned. This is the value required for length if all structure identifiers are to be returned. 

ERRORS

007Ignoring function, function requires state (PHOP, ∗, ∗, AROP)

404Ignoring function, the specified archive file is not open

SEE ALSO

INQUIRE CONFLICTING STRUCTURES IN NETWORK (3P)

September 02, 1992