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 |