[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPCLWS - Close Workstation

GPCLWS (wsid)

Purpose

Use GPCLWS to close the specified workstation. The workstation updates automatically before closing.

This subroutine function releases the workstation state list and deletes the workstation's identifier from the set of opened workstations in the graPHIGS API state list. Additionally, GPCLWS flushes the input queue of all events from all input devices on the workstation, and releases the connection to the workstation. If no workstation remains open, the workstation state is set to Workstation Closed (WSCL)

GPCLWS clears the workstation. For workstations that keep a local copy of the structure store, the graPHIGS API frees the structure storage at this time.

This subroutine is functionally equivalent to the Detach Resource (GPDTR) subroutine with a resource type set to 1=WORKSTATION

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
147
EVENT QUEUE HAS OVERFLOWED

Related Subroutines

GPCRWS
Create Workstation
GPDTR
Detach Resource
GPOPWS
Open Workstation
GPQOPW
Inquire Set of Open Workstations

RCP code

201327617 (X'0C000401')


[ Previous | Next | Contents | Glossary | Home | Search ]