lineSetAgentStateEx

The lineSetAgentStateEx function sets the agent state associated with a particular agent handle. It generates a LINE_PROXYREQUEST message to be sent to a registered proxy function handler, referencing a LINEPROXYREQUEST structure of type LINEPROXYREQUEST_SETAGENTSTATEEX.

LONG  lineSetAgentStateEx(       
  HLINE hLine,                   
  HAGENT hAgent,                 
  DWORD dwAgentState,            
  DWORD dwNextAgentState         
);

Parameters

hLine

A handle to the line device.

hAgent

The identifier of the agent whose information is to be changed.

dwAgentState

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

dwNextAgentState

The next agent state. Must be one of the LINEAGENTSTATEEX_ constants or zero.

Return Values

Returns a request identifier if the asynchronous operation starts; otherwise, the function returns one of the following error values:

LINEERR_INVALAGENTSTATE
LINEERR_INVALLINEHANDLE
LINEERR_INVALPARAM
LINEERR_NOMEM
LINEERR_OPERATIONFAILED
LINEERR_OPERATIONUNAVAIL
LINEERR_RESOURCEUNAVAIL
LINEERR_UNINITIALIZED

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Version: Requires TAPI 2.2 or later.
  Header: Declared in Tapi.h.
  Library: Use Tapi32.lib.

See Also

About TAPI 3.0 Call Center Controls, LINEPROXYREQUEST, LINE_PROXYREQUEST