Creates and opens the specified screen.
#include <screen.h>
int OpenScreen (
const char *name,
rtag_t rTag,
scr_t *newScrID);
(IN) Points to a null-terminated string, which gives a name to the screen.
(IN) Specifies a resource tag. See Resource Tag Signatures
in Volume 2.
(OUT) Points to a handle for screen, which is used to identify the screen for most other screen operations.
If successful, returns 0.
The OpenScreen function creates a screen for the NLM. To make the screen the current displayed screen on the console, call ActivateScreen.
Screens created with the OpenScreen function can be managed only with NetWare OS functions. For example, your application's stdin and stdout are not mapped to this screen, and therefore you cannot use standard functions for input or output. Use the following types of functions:
To obtain input from the screen, use GetKey.
To send output to the screen, use OutputToScreen.
To close and destroy the screen, call CloseScreen.
To create a screen which is accessible through stdin, stdout, and stderr, see Designating an Application Screen.