lineSetQueueMeasurementPeriod function (tapi.h)

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

Syntax

LONG lineSetQueueMeasurementPeriod(
  HLINE hLine,
  DWORD dwQueueID,
  DWORD dwMeasurementPeriod
);

Parameters

hLine

Handle to the line device.

dwQueueID

Identifier of the queue whose information is to be changed.

dwMeasurementPeriod

New measurement period (seconds). Must be greater than zero.

Return value

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

Requirement Value
Target Platform Windows
Header tapi.h
Library Tapi32.lib
DLL Tapi32.dll

See also

About Call Center Controls

LINEPROXYREQUEST

LINE_PROXYREQUEST