Compartilhar via


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

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.

Retornar valor

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
Existe 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

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

Confira também

ITAgent

ITAgent::CreateSession

ITAgentSession