Compartilhar via

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

  • Artigo

O método CreateSessionWithPIN cria uma nova sessão de agente para o grupo e endereço ACD de entrada, com o PIN (Número de Identificação Pessoal).

Sintaxe

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

Parâmetros

[in] pACDGroup

Ponteiro para a interface ITACDGroup .

[in] pAddress

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

[in] pPIN

Ponteiro para uma representação BSTR do PIN do agente.

[out] ppAgentSession

Ponteiro para a sessão criada.

Valor retornado

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 O método foi bem-sucedido.
TAPI_E_CALLCENTER_NO_AGENT_ID
 Agente não criado por CreateAgentWithID.
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.
E_INVALIDARG
 pPIN é NULL.
E_POINTER
 O parâmetro pPIN ou ppAgentSession não é um ponteiro válido.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para pPIN e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

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

Requisitos

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

Confira também

ITAgent

ITAgent::CreateSession

ITAgentSession