GPHIGS C FUNCTIONS - INQUIRE LIST OF VIEW INDICES

INQUIRE LIST OF VIEW INDICES

PINQ_LIST_VIEW_INDS

CALL SEQUENCE

void pinq_list_view_inds(

Pint	ws_id,	/* workstation identifier	*/
Pint 	length,	/* length of application list	*/
Pint	start,	/* starting position	*/
Pint	*error_ind,	/* (out) error indicator	*/
Pint_list	*indices,	/* (out) list of view indices	*/
Pint 	*total_length	/* (out) length of list in GPHIGS	*/

TYPES

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

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Returns view indices defined in workstation ws_id's workstation state list. The list is sorted in view input priority order, the first having the highest priority.

If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters.

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
54: Ignoring function, the specified workstation is not open
57: Ignoring function, specified workstation is of category MI