Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
4-39
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
Chapter 4 Building Your Application
Logging In and Logging Out an Agent
rArgs.SetValue(CtiOs_IKeywordIDs.CTIOS_AUTOLOGIN, “1”);
/* 3. Log in the agent.*/
int returnValue = agent.Login(rArgs);
}
Note
It is the client application’s responsibility to keep track of whether the log in
attempt is the first attempt, or during failover, and branch accordingly in the
SetAgentMode() event to avoid calling the Login() method during failover.
attempt is the first attempt, or during failover, and branch accordingly in the
SetAgentMode() event to avoid calling the Login() method during failover.
The Login() method generates the following events:
•
QueryAgentStateConf()
•
AgentStateEvent(), if the agent is unknown or is logged out.
Note
The client application receiving the these events must check both the
ENABLE_LOGOUT and ENABLE_LOGOUT_WITH_REASON bitmasks.
For more information, see
ENABLE_LOGOUT and ENABLE_LOGOUT_WITH_REASON bitmasks.
For more information, see
When not successful, the Login() method generates the eControlFailureConf()
event.
event.
How to Handle Duplicate Log In Attempts
Overview
A duplicate log in attempt is when an agent who is already logged in tries to log
in a second time using the same ID. Desktop applications must account for such
a possible situation and have a plan for dealing with it.
in a second time using the same ID. Desktop applications must account for such
a possible situation and have a plan for dealing with it.
You can handle duplicate log in attempts in three ways:
•
Allow the Duplicate Log In with No Warning
•
Allow the Duplicate Log In with a Warning
•
Do not allow a duplicate log in.
You control how duplicate log in attempts are handled in two ways: