Platform SDK: TAPI

ITAgent::CreateSessionWithPIN

Creates a new agent session for the input ACD group and address, with Personal Identification Number (PIN).

HRESULT CreateSessionWithPIN(
  ITACDGroup *pACDGroup,
  ITAddress *pAddress,
  BSTR pPIN,
  ITAgentSession **ppAgentSession
);

Parameters

pACDGroup: [in] Pointer to ITACDGroup interface.
pAddress: [in] Pointer to ITAddress interface for object available for receiving ACD calls.
pPIN: [in] Pointer to a BSTR representation of agent's PIN.
ppAgentSession: [out, retval] Pointer to session created.

Return Values

Value	Meaning
S_OK	Method succeeded.
TAPI_E_CALLCENTER_NO_AGENT_ID	Agent not created by CreateAgentWithID.
TAPI_E_TIMEOUT	The operation failed because the TAPI 3.0 DLL timed it out. The timeout interval is two minutes.
E_INVALIDARG	pPIN is NULL.
E_POINTER	The pPIN or ppAgentSession parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

The application must use SysAllocString to allocate memory for pPIN and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

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

ITAgent::CreateSessionWithPIN

Parameters

Return Values

Remarks

Requirements

See Also