Función lineSetAgentState (tapi.h)

La función lineSetAgentState establece el estado del agente asociado a una dirección determinada.

Sintaxis

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

Parámetros

hLine

Controle el dispositivo de línea.

dwAddressID

Identificador de la dirección para la que se va a cambiar la información del agente. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwAgentState

Nuevo estado del agente. Debe ser una de las LINEAGENTSTATE_ constantes o cero para dejar el estado del agente sin cambios y modificar solo el siguiente estado.

dwNextAgentState

Estado del agente que se debe establecer automáticamente cuando la llamada actual en la dirección se vuelve inactiva. Por ejemplo, si se sabe que se debe realizar el trabajo posterior a la llamada, este campo se puede establecer en LINEAGENTSTATE_WORKAFTERCALL para que no se asigne una nueva llamada al agente después de la llamada actual. Debe ser una de las LINEAGENTSTATE_ constantes o cero para usar el siguiente estado predeterminado configurado para el agente.

Valor devuelto

Devuelve un identificador de solicitud positivo si se inicia la operación asincrónica; de lo contrario, la función devuelve uno de estos valores de error negativos:

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

Funciones complementarias del servicio de línea

Introducción a la referencia de TAPI 2.2