Display Window (QsnDspWin) API
Required Parameter:
1 | Window handle | Input | Binary(4) |
Omissible Parameter:
2 | Error code | I/O | Char(*) |
Returned Value:
Return code | Output | Binary(4) |
Default Public Authority: *USE
Service Program: QSNAPI
Threadsafe: No
The Display Window (QsnDspWin) API draws the window border for the current window and clears the window area. The QsnDspWin API does not make a window current. It simply redraws the window using the existing border attributes. For overlapping windows, use this API only for the current window. If a Draw Window exit routine is specified on the window description, this routine is called after the window is defined successfully and prior to actually drawing the window.
Authorities and Locks
None.
Required Parameter
- Window handle
- INPUT; BINARY(4)
A handle for the window to be drawn.
Omissible Parameter
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.
Returned Value
- Return code
- OUTPUT; BINARY(4)
A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.
Error Messages
Message ID | Error Message Text |
---|---|
CPF24B4 E | Severe error while addressing parameter list. |
CPF3CF1 E | Error code parameter not valid. |
CPF3CF2 E | Error(s) occurred during running of &1 API. |
CPFA318 E | Error calling exit routine. |
CPFA31E E | Required parameter &1 omitted. |
CPFA343 E | Output operation not done. |
CPFA344 E | The file &2 in library &3 is not valid. |
CPFA345 E | The invite active flag is not valid. |
CPFA3A4 E | Specified window is not active. |
CPFA3AA E | Window handle incorrect. |
API introduced: V2R3
[ Back to top | Dynamic Screen Manager APIs | APIs by category ]