INQUIRE SET OF WORKSTATIONS TO WHICH POSTED(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE SET OF WORKSTATIONS TO WHICH POSTED − inquire list of workstations to which a structure is posted

SYNOPSIS

C Syntax

void
pinq_wss_posted ( struct_id, length, start, error_ind, ws, total_length )
Pintstruct_id;structure identifier
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint_list∗ws;OUT list of workstations
Pint∗total_length;OUT length of list in PHIGS

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE SET OF WORKSTATIONS TO WHICH POSTED to obtain a list of workstations to which a specified structure is posted.

C Input Parameters

struct_id
Identifier of the structure for which the list of workstations it is posted to will be returned.

lengthThe number of ints items in the ws output parameter for which the application has allocated memory. length is the number of list elements (workstation 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 workstations the structure is posted to will be returned in total_length.

startStarting position of inquiry into the list of workstations to which this structure is posted. The elements of the list of workstation identifiers, beginning with the item number specified by start, are copied sequentially into ints until ints is full or all the workstation 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.

wsA pointer to a Pint_list structure in which the system returns the list of workstations to which struct_id is posted. Pint_list is defined in phigs.h as follows:

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

The num_ints component specifies the number of workstation identifiers in the list. The ints component is a pointer to a list, num_ints long, of the workstation identifiers.

The application must allocate memory for length elements in the ints list.

total_length
A pointer to an integer in which the system returns the total number of workstations to which the specified structure is posted. This is the value required for length if the entire list is to be returned.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

201Ignoring function, the specified structure does not exist

Museum