Cisco Cisco Computer Telephony Integration Option 9.0 Guide Du Développeur

A successful request results in an OnAgentGreetingControlConf event. If this request is unsuccessful, 
the client receives an OnControlFailureConf event.

The SetAgentState method requests a new agent state. Login and Logout are valid agent states and can 
be set using the SetAgentState method as well as by using the Login and Logout methods.

int SetAgentState(Arguments& args)

HRESULT SetAgentState (/*[in]*/ IArguments *args, /*[out,retval]*/ int * 

errorcode)

SetAgentState (args As CTIOSCLIENTLib.IArguments) As Long

int SetAgentState(Arguments args)

CilError SetAgentState(Arguments args)

args

Input parameter in the form of an Arguments array that contains one or more of the SetAgentState 
parameters listed in the following table.

AgentState (required)

INT

The state to which to set the specified agent. The 
value of this field must be one of the values in 

AgentID (required)

STRING

*

The agent’s login ID.

AgentInstrument

STRING

*

The agent’s instrument number. Optional if Agent 
Extension is provided.

PositionID

STRING

*

Required for Alcatel only.

AgentPassword (optional)

STRING

*

The agent’s password.

AgentWorkMode (optional)

INT

A value representing the desired work mode of the 
agent. Used by ACM ECS with default value of 
ManualIn.

NumSkillGroups (optional)

INT

The number of Skill Groups that the agent is 
currently associated with, up to a maximum of 20. 

EventReasonCode (optional)

INT

Reason for logging out. Required for Unified CCE, 
optional for all other switches.

PeripheralID (optional)

INT

The Unified ICM Peripheral ID of the ACD the 
agent is attached to.