TCOM_Logger
What: class
Ancestor: TBase_Object
File: _Loggers
Layer: 0
Platforms: C++, Pascal (Delphi)
Defines an abstract base COM class for loggers. The methods all stdcall and they are:
Log_Message
bool Log_Message( char* Mess, int32 Level )
function Log_Message( Mess : string ; Level : integer ) : boolean
This procedure is called to log informational messages
to the code supplying the logger. Mess is the message
text, and Level indicates the type of message. The return value
indicates whether or not to abort the process which
created the message. If the result is True the
process should be terminated gracefully as quickly as possible.
Log_Nested_Message
bool Log_Nested_Message( char* Mess, int32 Level )
function Log_Nested_Message( Mess : string ; Level : integer ) : boolean
Same as Log_Message, but the message will be followed
by a Unnest_Message call when the condition causing the message goes out of scope.
Unnest_Message
bool Unnest_Message( int32 Level )
function Unnest_Message( Level : integer ) : boolean
This indicates the end of the condition under which the
previous message with the specified level occurred.
If True is returned, the process should be
terminated gracefully as quickly as possible.
Check_Terminate
bool Check_Terminate()
function Check_Terminate : boolean
This function is called during a long process to allow
for the user to abort it or for checking Windows
messages, etc. If the function returns True, the
process should be terminated gracefully as quickly as possible.