INQUIRE WORKSTATION CONNECTION AND TYPE(3P) — Kubota Pacfic Computer Inc. (15 August 1991)

NAME

INQUIRE WORKSTATION CONNECTION AND TYPE− inquire a workstation’s connection identifier and type

SYNOPSIS

C Syntax

void
pinq_ws_conn_type ( ws, store, error_ind, conn_id, ws_type )
Pintws;workstation identifier
Pstore store; handle to Store object
Pint∗error_ind;OUT error indicator
Pconnid ∗conn_id;OUT connection identifier
Pint∗ws_type;OUT workstation type

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE WORKSTATION CONNECTION AND TYPE to inquire the specific workstation type and connection identifier associated with a given workstation. The connection identifier and workstation type are associated with a workstation when it is opened. At that time a specific workstation type is created, based on the generic type supplied by the caller, and the specific workstation type and the user-supplied connection identifier are stored in the workstation’s state list. This function returns that specific workstation type and the connection identifier. See OPEN WORKSTATION for descriptions of the possible connection identifiers and generic workstation types.

C Input Parameters

wsThe workstation identifier of the workstation in question.

string_length
The size of the buffer (in bytes) pointed to by connid for the connection identifier to be returned in.

C Output Parameters

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

conn_id
A pointer to a Pconnid (a pointer to the connection identifier).

ws_type
A pointer to a Pint variable in which to store the workstation type.

Execution

INQUIRE WORKSTATION CONNECTION AND TYPE returns the specific workstation type and connection identifier associated with the specified workstation. See OPEN WORKSTATION for a description of the possible connection identifiers and workstation types.

Except in the case mentioned in the C Parameters sections above, if an error is detected by this function the error indicator will indicate the error number of the error detected and no other output data will be returned. If no error is detected, the error indicator will be set to zero and the inquired information will be available in the output parameters. Since this is an inquiry function, ERROR HANDLING is not invoked when an error is detected by this function.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

2200Buffer overflow in input or inquiry function

Museum