Platform SDK: TAPI

ITAgent::CreateSession

Creates a new agent session for the input ACD group and address.

HRESULT CreateSession(
  ITACDGroup *pACDGroup,
  ITAddress *pAddress,
  ITAgentSession **ppAgentSession
);

Parameters

pACDGroup: [in] Pointer to ITACDGroup interface.
pAddress: [in] Pointer to ITAddress object available for receiving ACD calls.
ppAgentSession: [out, retval] Pointer to ITAgentSession interface for object created.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_POINTER	The ppAgentSession parameter is not a valid pointer.
E_UNEXPECTED	Failed to open a line for the target Address.
E_INVALIDARG	The pACDGroup or pAddress argument is not valid.
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.

Remarks

Some telephone environments require a personal identification number to open a session. See CreateSessionWithPIN.

Requirements

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

ITAgent::CreateSession

Parameters

Return Values

Remarks

Requirements

See Also