Compartilhar via


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

O método CreateSession cria uma nova sessão de agente para o grupo e o 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
Há 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 telefônicos exigem um número de identificação pessoal para abrir uma sessão. Consulte CreateSessionWithPIN.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3cc.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

IEnumAgentSession

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession