DropPopUpScreen

Redisplays the screen that the popup screen covered

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

Syntax

  #include <nwconio.h>  
   
  int DropPopUpScreen  (  
     int   screenHandle); 
  

Parameters

screenHandle

(IN) Specifies the screen handle of the popup screen.

Return Values

The following table lists return values and descriptions.

Value

Hex

Name

Description

0

(0x00)

ESUCCESS

Successful.

22

(0x16)

EBADHNDL

Bad screen handle was passed in.

105

(0x69)

ERR_NOT_A_POPUP_SCREEN

 

WARNING:An invalid screen handle is not guaranteed to return EBADHANDLE; it can also cause the server to abend. Always pass a handle returned from CreateScreen or GetScreenInfo.

Remarks

This function redisplays the screen the popup screen covered if the popup screen is the displayed screen when this function is called and the covered screen still exists. In addition, the screen that was covered is made current if it is a screen owned by the calling NLM.

See Also

DestroyScreen, DisplayScreen