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

Artigo
03/02/2024

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.