Compartilhar via

Método ITAgentHandler::CreateAgentWithID (tapi3.h)

  • Artigo

O método CreateAgentWithID cria um objeto Agent com base em um identificador de agente. Esse identificador é uma cadeia de caracteres que identifica o agente em um sistema ACD herdado. Se o sistema também exigir um PIN ou senha para fazer logon em grupos, você usará esse método para definir o PIN ou a senha.

Sintaxe

HRESULT CreateAgentWithID(
  [in]  BSTR    pID,
  [in]  BSTR    pPIN,
  [out] ITAgent **ppAgent
);

Parâmetros

[in] pID

Ponteiro para BSTR que contém o identificador do agente.

[in] pPIN

Ponteiro para BSTR que contém o PIN do agente.

[out] ppAgent

Ponteiro para a interface ITAgent .

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 O parâmetro pPIN é NULL.
E_POINTER
 O parâmetro ppAgent não é um ponteiro 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 aplicativo deve usar SysAllocString para alocar memória para os parâmetros pID e pPIN e usar SysFreeString para liberar a memória quando as variáveis não forem mais necessárias.

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

Requisitos

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

Confira também

CreateAgent

ITAgent

ITAgentHandler