lineSetAgentState
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.