GEOS SDK TechDocs
|
| 
5.1 Adding EC Code to Your Program
| 
6 Inter-Application Communication
SysGetECLevel(), SysSetECLevel(), SysNotify(), EC...(), CFatalError(), CWarningNotice()
While using Swat and the EC version, you can set and retrieve the current level of error checking employed. The level is set with a record of flags, each of which determines whether a certain type of checking is turned on. This record is of type
ErrorCheckingFlags
.
You can retrieve it with
SysGetECLevel()
and set it with
SysSetECLevel()
.
SysNotify()
puts up the standard error dialog box--white with a black frame. This routine is available in both the EC and the non-EC versions of the kernel. This is the box used by the kernel to present unrecoverable errors to the user. You can also call it up and allow the user any of five options: retry, abort, continue, reboot, or exit. Usually, this dialog box is used only for errors, but it can be used for other user notification as well. (Note that with the "exit" and "reboot" options, this routine will
not
return. Note also that only certain combinations of the five options are supported.)
The
CFatalError()
and
CWarningNotice()
routines provide run-time and compile-time error or warning messages. The
CFatalError()
routine calls the kernel's
FatalError()
function, which puts up an error dialog box and, in Swat, causes Swat to hit a breakpoint so you can debug the error.
CWarningNotice()
may be put in error-checking code to make the compiler put up a compile-time warning note.
GEOS SDK TechDocs
|
| 5.1 Adding EC Code to Your Program
| 6 Inter-Application Communication