ITQueue::get_FinalDisposition method (tapi3.h)

Article
02/22/2024

The get_FinalDisposition method gets the total number of calls reaching the bottom of a call guide during the current measurement period. This indicates that a call has passed through an ACD system, moving from queue to queue, without being answered, which indicates a problem with the queue design or response times.

The measurement period is switch- or implementation-specific. (See get_MeasurementPeriod.)

Syntax

HRESULT get_FinalDisposition(
  [out] long *plCalls
);

Parameters

[out] plCalls

Pointer to number of calls.

Return value

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
E_POINTER	The plCalls is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
TAPI_E_TIMEOUT	The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.

Remarks

Measurement period for this information is switch and/or implementation specific (see get_MeasurementPeriod).

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3.h (include Tapi3.h)
Library	Uuid.lib
DLL	Tapi3.dll