Método ITAgent::CreateSession (tapi3cc.h)

Artículo
03/05/2024

El método CreateSession crea una nueva sesión de agente para el grupo y la dirección de ACD de entrada.

Sintaxis

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

Parámetros

[in] pACDGroup

Puntero a la interfaz ITACDGroup .

[in] pAddress

Puntero al objeto ITAddress disponible para recibir llamadas ACD.

[out] ppAgentSession

Puntero a la interfaz ITAgentSession para el objeto creado.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro ppAgentSession no es un puntero válido.
E_UNEXPECTED	No se pudo abrir una línea para la dirección de destino.
E_INVALIDARG	El argumento pACDGroup o pAddress no es válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
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.

Comentarios

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

Algunos entornos telefónicos requieren un número de identificación personal para abrir una sesión. Consulte CreateSessionWithPIN.