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

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 de 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 de teléfono requieren un número de identificación personal para abrir una sesión. Consulte CreateSessionWithPIN.

Requisitos

   
Plataforma de destino Windows
Encabezado tapi3.h (incluya Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

IEnumAgentSession

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession