| GEOS SDK TechDocs | | StreamWrite() ... | SysShutdown() ...

---

SysGetPenMode()

Boolean	SysGetPenMode();

This routine returns true if GEOS is running on a pen-based system, false if it is not.

Include: system.h

SysLocateFileInDosPath()

DiskHandle SysLocateFileInDosPath( /* sets thread's error value */
        const char		* fname,				/* file name */
        char		* buffer);				/* returned path of file */

This routine searches for a specified file along the search path specified in the DOS environment variable PATH. The parameters are

fname

A pointer to the null-terminated file name to search for.

buffer

A pointer to a locked or fixed buffer into which the full path of the file will be placed.

This routine returns the disk handle of the disk on which the file resides as well as the file's full path (with drive name) in the buffer pointed to by buffer . The path returned is a null-terminated character string. If the file could not be found, a null disk handle will be returned. The error value can be retrieved with ThreadGetError() .

Include: system.h

SysNotify()

word	SysNotify(
        SysNotifyFlags		flags,				/* options to offer user */
        const char 		* string1,				/* first string to display */
        const char 		* string2);				/* second string to display */

This routine causes the kernel to put up a standard notification dialog box on the screen. This dialog box is white with a black border and is used nearly exclusively for error notification by the kernel. Pass this routine the following parameters:

flags

A record of SysNotifyFlags indicating the options the dialog presents to the user. These flags are shown below.

string1

A pointer to a null-terminated character string put up in the dialog box (may be a null pointer).

string2

A pointer to a second null-terminated string presented in the dialog box (may be a null pointer).

The returned word is the user's response, based on the SysNotifyFlags passed (see below).

Structures: SysNotifyFlags is a record of several flags; none, any, or all of the flags may be set at a time. The five flags are

SNF_RETRY

Allow the user to retry the operation that brought up the notification box. If the user selects this option, it will be returned by the routine.

SNF_EXIT

Allow the user to exit GEOS entirely. If the user selects this option, it will be returned by the routine after an SST_CLEAN_FORCED shutdown has been initiated.

SNF_ABORT

Allow the user to abort the operation that brought up the notification box. If the user selects this option, it will be returned by the routine.

SNF_CONTINUE

Allow the user to continue the operation. If the user selects this option, it will be returned by the routine.

SNF_REBOOT

Allow the user to shut down and reboot GEOS directly. If the user selects this option, the routine will not return.

Include: system.h

SysRegisterScreen()

void	SysRegisterScreen(
        GeodeHandle		driver,
        WindowHandle		root);

 

SysSetECLevel()

void	SysSetECLevel(
        ErrorCheckingFlags		flags,					/* level of error checking */
        MemHandle		checksumBlock);					/* block to check, if any */	

This routine sets the error-checking level of the software. Pass it a record of ErrorCheckingFlags indicating which levels of error checking should be employed. If checksum checking (ECF_BLOCK_CHECKSUM) is turned on, also pass the handle of a block on which the checksum will be performed.

Include: ec.h

SysSetExitFlags()

word	SysGetExitFlags(
        ExitFlags		bitsToSet,
        ExitFlags		bitsToClear);