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

Artigo
03/05/2024

O método CreateSession cria uma nova sessão de agente para o grupo e endereço ACD de entrada.

Sintaxe

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

Parâmetros

[in] pACDGroup

Ponteiro para a interface ITACDGroup .

[in] pAddress

Ponteiro para o objeto ITAddress disponível para receber chamadas ACD.

[out] ppAgentSession

Ponteiro para a interface ITAgentSession para o objeto criado.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro ppAgentSession não é um ponteiro válido.
E_UNEXPECTED	Falha ao abrir uma linha para o Endereço de destino.
E_INVALIDARG	O argumento pACDGroup ou pAddress não é válido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

O TAPI chama o método AddRef na interface ITAgentSession retornada por ITAgent::CreateSession. O aplicativo deve chamar Release na interface ITAgentSession para liberar recursos associados a ele.

Alguns ambientes de telefone exigem um número de identificação pessoal para abrir uma sessão. Consulte CreateSessionWithPIN.