Función lineSetAgentStateEx (tapi.h)

La función lineSetAgentStateEx establece el estado del agente asociado a un identificador de agente determinado. Genera un mensaje LINE_PROXYREQUEST que se va a enviar a un controlador de función de proxy registrado, haciendo referencia a una estructura LINEPROXYREQUEST de tipo LINEPROXYREQUEST_SETAGENTSTATEEX.

Sintaxis

LONG lineSetAgentStateEx(
  HLINE  hLine,
  HAGENT hAgent,
  DWORD  dwAgentState,
  DWORD  dwNextAgentState
);

Parámetros

hLine

Identificador del dispositivo de línea.

hAgent

Identificador del agente cuya información se va a cambiar.

dwAgentState

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

dwNextAgentState

Siguiente estado del agente. Debe ser una de las constantes LINEAGENTSTATEEX_ o cero.

Valor devuelto

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

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

Requisitos

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

Consulte también

Acerca de los controles del centro de llamadas

LINEPROXYREQUEST

LINE_PROXYREQUEST