Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 490
   
12-32
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Chapter 12      Helper Classes
Logger Class (.NET and Java Only)
Syntax
C++: 
     
 
int WaitOnMultipleEvents(DWORD dwMilliseconds = 
INFINITE);
Java, .NET: 
int WaitOnMultipleEvents(long iMilliseconds);
Parameters
Milliseconds
The maximum length of time in milliseconds to wait before timing out. The default is INFINITE if 
called without arguments. For Java and .NET, a value of zero causes this method to wait infinitely.
Return Values
The WaitOnMultipleEvents method returns one of the values listed in 
Logger Class (.NET and Java Only)
The Logger class creates a Logger object and a LogManager object, if one does not already exist. Any 
object that needs to perform logging must instantiate the Logger class. The Logger class communicates 
with the singleton LogManager object, which acts as the centralized logging facility. The Logger class also 
defines tracing constants.
Methods
 list the methods in the Logger class.
Table 12-9
WaitOnMultipleEvents Return Values
Value
When Returned
EVENT_SIGNALED
If one of the events in the mask occurred.
EVENT_WAIT_TIMEDOUT
If the timeout period elapsed.
WAIT_FAILED
If unable to wait on the events in the mask.
Table 12-10
CWaitObject Class Methods
Method
Description
AddLogListener
Registers a listener with the LogManager.
GetTraceMask
Gets the current trace mask. Trace masks define trace levels, such 
as TRACE_MASK_CRITICAL, which enables tracing for critical 
errors. See the LogManager Javadoc for a description of trace 
masks that define tracing.
Logger (Constructor)
Creates a Logger object and also a LogManager object if one does 
not already exist. If one is already created, it just gets a reference to 
the existing singleton LogManager object. 
RemoveLogListener
Unregisters a listener from the LogManager.