SetCtrlCharCheckMode

Enables or disables control-character checking for the current screen

Local Servers:nonblocking
Remote Servers:N/A
Classification:3.x, 4.x, 5.x, 6.x
Service:Screen Handling

Syntax

  #include <nwconio.h>  
   
  BYTE SetCtrlCharCheckMode  (  
     BYTE   newMode);

Parameters

newMode

(IN) Specifies TRUE = Enable control-character checking. FALSE = Disable control-character checking.

Return Values

This function returns the value of the old control-character check mode setting.

If an error occurs, the function returns -1 and errno is set to:

Value

Hex

Name

Description

23

(0x17)

ENO_SCRNS

Screen I/O was attempted when no screens were open.

Remarks

Set the newMode parameter to TRUE if control characters are to be checked for, and FALSE otherwise. The control characters to check for are Ctrl+C and Ctrl+S.

  • Ctrl+C terminates the NLM abnormally (via the abort function).

  • Ctrl+S pauses output (pressing any key resumes output).