Creates and opens the specified custom screen.
#include <screen.h>
int OpenCustomScreen (
const char *name,
rtag_t rTag,
scr_t *newScrID,
int mode );
(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.
(IN) Specifies the screen mode, using the following values:
If successful, returns 0.
The OpenCustomScreen function creates a screen for the NLM. To make the screen the current displayed screen on the console, call ActivateScreen.
Screens created with the OpenCustomScreen 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 or InputFromScreen.
To send output to the screen, use OutputToScreen.
To close and destroy the screen, call CloseScreen.
This is the only interface by which a scrollable screen can be explicitly created. For sample code, see Scroll.c.
To create a scrollable screen which is accessible through stdin, stdout, and stderr, see Designating an Application Screen.