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

INQUIRE WORKSTATION CONNECTION AND TYPE (PHOP,WSOP,*,*)

Purpose

Use Inquire Workstation Connection and Type to inquire the connection identifier and the realized workstation type of the specified workstation identifier. The realized workstation type is the type assigned by the graPHIGS API when the workstation is created by the Open Workstation subroutine.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

3
FUNCTION REQUIRES STATE (PHOP,WSOP,*,*)
54
SPECIFIED WORKSTATION IS NOT OPEN

Language Bindings

C

pinq_ws_conn_type (ws_id, store, err_ind, conn_id, ws_type);

Input Parameters
Pint    ws_id
Workstation identifier. 

Pstore  store
Handle to the Store identifier. The graPHIGS APIuses an object of type Store to facilitate the use of subroutines which return complex data. See Create Store subroutine for details on how the graPHIGS API uses this parameter on inquiries.

Output Parameters

Pint    *err_ind
Error indicator. 

void    **conn_id
Connection identifier. The memory referenced by *conn_id is managed by the parameter store . 

Pint    *ws_type
Workstation type.

FORTRAN

pqwkc (wkid, errind, conid, wtype)

Input Parameters

integer wkid
Workstation identifier.

Output Parameters

integer errind
Error indicator.

integer conid
Connection identifier.

integer wtype
Workstation type.

Errors

None

Related Subroutines

None

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