Platform SDK: TAPI

lineSetAgentMeasurementPeriod

The lineSetAgentMeasurementPeriod function sets the measurement period associated with a particular agent. It generates a LINE_PROXYREQUEST message to be sent to a registered proxy function handler, referencing a LINEPROXYREQUEST structure of type LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD.

LONG lineSetAgentMeasurementPeriod(
  HLINE hLine,                    
  HAGENT hAgent,                   
  DWORD dwMeasurementPeriod        
);

Parameters

hLine
A handle to the line device.
hAgent
The identifier of the the agent whose information is to be changed.
dwMeasurementPeriod
The new measurement period (seconds). Must be greater than zero.

Return Values

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

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