lineSetAgentState  N9Y735 

The lineSetAgentState function sets the agent state associated with a particular address.

LONG lineSetAgentState(

    HLINE hLine,

 

    DWORD dwAddressID,

 

    DWORD dwAgentState,

 

    DWORD dwNextAgentState

 

   );

 

 

Parameters

hLine

Handle of the line device.

dwAddressID

Identifier of the address for which the agent information is to be changed.

dwAgentState

The new agent state. Must be one of the LINEAGENTSTATE_ constants, or 0 to leave the agent state unchanged and modify only the next state.

dwNextAgentState

The agent state that should be automatically set when the current call on the address becomes idle. For example, if it is known that after-call work must be performed, this field can be set to LINEAGENTSTATE_WORKAFTERCALL so that a new call will not be assigned to the agent after the current call. Must be one of the LINEAGENTSTATE_ constants, or 0 to use the default next state configured for the agent.

 

Return Values

Returns a positive request identifier if the asynchronous operation starts; otherwise, one of these negative error values:

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.