acutAssertMessage

C++

ACPAL_PORT void acutAssertMessage(
    const ACHAR * condition, 
    const ACHAR * filename, 
    int lineNumber, 
    const ACHAR * status
);

File

acutasrt.h

Description

This function uses the Win32 message box to display a message on the screen containing the condition string, file name, line number, and optional status message. In addition to the message on the screen, this function records the condition, file name, line number, and status message to a file whose name is derived from the invoking application or DLL's file name with an appended ".err" extension. The file resides in the same directory as the application or DLL.

The message is displayed on screen in a task-modal dialog with buttons for abort, retry, and ignore. Pressing abort will call the current host application's fatalError() function. Pressing retry will break into the debugger. Pressing ignore will return to the caller for continued execution.

Pass in null for the status argument if no status message is desired.

Because this function is only intended to be called when coding assumptions fail (as is the case for assertion macros), the amount of information displayed in the message box is limited.

Only the first 400 bytes of the condition string, the first _MAX_PATH bytes of the file name, and the first 200 bytes of the status string are used.

Parameters