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

GPSMST - Sample String

GPSMST (wsid, device, length, number, string)

Purpose

Use GPSMST to retrieve the current measure of the specified string device.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

String device number (>=1)

length -- specified by user, fullword integer

Length, in bytes, of string array provided by the application in which the graPHIGS API returns the string data (>=0)

number -- returned by the graPHIGS API, fullword integer

Number of bytes returned.

string -- returned by the graPHIGS API, variable length character string

Character string.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
140
DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
505
LENGTH OF RETURN ARRAY < ZERO

Related Subroutines

GPQLI
Inquire List of Logical Input Devices
GPSTMO
Set String Mode

RCP code

201335558 (X'0C002306')

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