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

Artículo
08/26/2023

El método CreateAgentWithID crea un objeto Agent basado en un identificador de agente. Este identificador es una cadena que identifica al agente en un sistema de ACD heredado. Si el sistema también requiere un PIN o una contraseña para iniciar sesión en grupos, use este método para establecer el PIN o la contraseña.

Sintaxis

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

Parámetros

[in] pID

Puntero a BSTR que contiene el identificador del agente.

[in] pPIN

Puntero a BSTR que contiene el PIN del agente.

[out] ppAgent

Puntero a la interfaz ITAgent .

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_INVALIDARG	El parámetro pPIN es NULL.
E_POINTER	El parámetro ppAgent no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
TAPI_E_TIMEOUT	Error en la operación porque el archivo DLL tapi 3 lo agotó. El intervalo de tiempo de espera es de dos minutos.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para los parámetros pID y pPIN , y usar SysFreeString para liberar la memoria cuando las variables ya no sean necesarias.

TAPI llama al método AddRef en la interfaz ITAgent devuelta por ITAgentHandler::CreateAgentWithID. La aplicación debe llamar a Release en la interfaz ITAgent para liberar recursos asociados.