Método ITAgent::CreateSessionWithPIN (tapi3.h)

Artículo
03/08/2023

El método CreateSessionWithPIN crea una nueva sesión de agente para el grupo y la dirección de ACD de entrada, con el número de identificación personal (PIN).

Sintaxis

HRESULT CreateSessionWithPIN(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [in]  BSTR           pPIN,
  [out] ITAgentSession **ppAgentSession
);

Parámetros

[in] pACDGroup

Puntero a la interfaz ITACDGroup .

[in] pAddress

Puntero a la interfaz ITAddress para el objeto disponible para recibir llamadas de ACD.

[in] pPIN

Puntero a una representación BSTR del PIN del agente.

[out] ppAgentSession

Puntero a la sesión creada.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
TAPI_E_CALLCENTER_NO_AGENT_ID	El agente no lo crea CreateAgentWithID.
TAPI_E_TIMEOUT	Error en la operación porque el archivo DLL tapi 3 lo agotó. El intervalo de tiempo de espera es de dos minutos.
E_INVALIDARG	pPIN es NULL.
E_POINTER	El parámetro pPIN o ppAgentSession no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para pPIN y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

TAPI llama al método AddRef en la interfaz ITAgentSession devuelta por ITAgent::CreateSessionWithPIN. La aplicación debe llamar a Release en la interfaz ITAgentSession para liberar recursos asociados a él.