Platform SDK: TAPI

ITQueue::put_MeasurementPeriod

Sets period (in seconds) for which the switch and/or implementation stores and calculates information.

HRESULT put_MeasurementPeriod(
  long lPeriod
);

Parameters

lPeriod
[in] Measurement period (in seconds).

Return Values

Value Meaning
S_OK Method succeeded.
E_INVALIDARG Value of lPeriod is zero.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
TAPI_E_TIMEOUT The operation failed because the TAPI 3.0 DLL timed it out. The timeout interval is two minutes.
LINEERR_ See lineSetQueueMeasurementPeriod for error codes returned from this TAPI 2.1 function.

Remarks

The ITQueue::put_MeasurementPeriod method is a COM wrapper for the TAPI 2.1 lineSetQueueMeasurementPeriod function.

This method will accept negative values for the measurement period, but this will normally result in unreliable statistics.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITQueue, get_MeasurementPeriod