Platform SDK: TAPI

ITAgentSession::get_SessionDuration

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.

HRESULT get_SessionDuration(
  long *plDuration
);

Parameters

plDuration
[out, retval] Pointer to session duration.

Return Values

Value Meaning
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.0 DLL timed it out. The timeout interval is two minutes.

Remarks

This method wraps the TAPI 2.1 lineGetAgentSessionInfo function.

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

ITAgentSession, lineGetAgentSessionInfo