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 |