SetAutoScreenDestructionMode

Enables or disables auto-screen destruction 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 SetAutoScreenDestructionMode  (  
     BYTE   newMode);

Parameters

newMode: (IN) Specifies TRUE = Enable auto-screen destruction. FALSE = Disable auto-screen destruction.

Return Values

This function returns the value of the old auto-screen destruction mode setting.

If an error occurs, the function returns a value of -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

If auto-screen destruction is disabled for a particular screen while the NLM is terminating, that screen remains open with the message <Press any key to close screen >. The screen does not close and the NLM does not continue with its termination until a key is pressed on that screen.