Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 546
 
Chapter 4      Building Your Application
Logging In and Logging Out an Agent
4-40
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
By configuring how duplicate log in attempts are to be handled on a global 
basis by creating custom values in the CTI OS Server Registry. By using 
custom values in the CTI OS Server registry to control how duplicate log in 
attempts are handled, and downloading these settings to your desktop 
application as described on page 4-45, you can enable flexibility without 
having to modify your desktop application code.
By implementing code in your desktop application to detect then to handle 
the duplicate log in attempt error according to the custom values in the CTI 
OS Server Registry. You can write code to handle duplicate log in attempts 
in each of the three ways listed above. Then when you must change how such 
attempts are handled, you would simply change the registry settings; you 
would then not need to change the desktop application code.
How to Create Values in the CTI OS Server Registry to Control Duplicate Log In 
Attempts
You can create keys in the CTI OS Server Registry that will instruct desktop 
applications to handle duplicate log in attempts in a specific way.
Warning
Two keys exist by default in the registry that are used by the CTI OS CIL: 
WarnIfAlreadyLoggedIn and RejectIfAlreadyLoggedIn. You must not use 
these keys in your desktop application. You must instead create other keys 
as described in this section. 
You should create two custom values:
custom_WarnIfAgentLoggedIn
custom_RejectIfAgentLoggedIn
The custom keys you create can be set to 0 (False) or 1 (True). 
The following table lists the settings to use to control how duplicate log in 
attempts are to be handled: