Compartir a través de

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

  • Artículo

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 a ella.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi3.h (incluya Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

CreateAgent

ITAgent

ITAgentHandler