ITAgentSession::get_SessionDuration method (tapi3cc.h)

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 tapi3cc.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

ITAgentSession

lineGetAgentSessionInfo