Edit

ITAgentSession::get_SessionDuration method (tapi3.h)

  • Article

The get_SessionDuration method gets the duration of the Agent session in seconds. This duration is for the active period only; timing stops when a session enters the ASST_SESSION_ENDED state of AGENT_SESSION_STATE.

Syntax

HRESULT get_SessionDuration(
  [out] long *plDuration
);

Parameters

[out] plDuration

Pointer to session duration.

Return value

This method can return one of these values.

Return code Description
S_OK
 Method succeeded.
E_OUTOFMEMORY
 Insufficient memory exists to perform the operation.
E_POINTER
 The plDuration parameter is not a valid pointer.
LINEERR_
 See lineGetAgentSessionInfo for error codes returned from this TAPI 2.1 function.
TAPI_E_TIMEOUT
 The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.

Remarks

This method wraps the TAPI 2.1 lineGetAgentSessionInfo function.

Requirements

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

See also

ITAgentSession

lineGetAgentSessionInfo