Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

26    Fatal Alert

System Management

Exploring Palm OS®

This chapter describes the Fatal Alert APIs, which provide a simple way to get the user's attention when a serious error occurs. The material in this chapter is organized as follows:

Fatal Alert Constants
Fatal Alert Functions and Macros

The header file FatalAlert.h declares the API that this chapter describes.

Fatal Alert Constants ^TOP^

Fatal Alert Actions ^TOP^

Purpose

Declared In

FatalAlert.h

Constants

#define fatalDoNothing 0xFFFFU
#define fatalEnter68KDebugger 2
#define fatalEnterBothDebugger 3
#define fatalEnterDebugger 1
#define fatalReset 0

Fatal Alert Functions and Macros ^TOP^

SysFatalAlert Function ^TOP^

Purpose

Display a fatal alert until the user taps a button in the alert.

Declared In

FatalAlert.h

Prototype

uint16_t SysFatalAlert (
   const char *msg
)

Parameters

msg
Message to display in the fatal alert dialog.

Returns

The dialog button that was tapped. The first button is zero.

SysFatalAlertInit Function ^TOP^

Purpose

Declared In

FatalAlert.h

Prototype

void SysFatalAlertInit (
   void
)

Parameters

None.

Returns