Función lineSetStatusMessages (tapi.h)

Artículo
08/26/2023

La función lineSetStatusMessages permite a una aplicación especificar qué mensajes de notificación recibir para eventos relacionados con los cambios de estado de la línea especificada o cualquiera de sus direcciones.

Sintaxis

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

Parámetros

hLine

Controle el dispositivo de línea.

dwLineStates

Matriz de bits que identifica para qué estado del dispositivo de línea cambia un mensaje se enviará a la aplicación. Este parámetro usa una o varias de las constantes de LINEDEVSTATE_.

dwAddressStates

Matriz de bits que identifica para qué estado de dirección cambia un mensaje se va a enviar a la aplicación. Este parámetro usa una o varias de las constantes de LINEADDRESSSTATE_.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

Comentarios

TAPI define una serie de mensajes que notifican a las aplicaciones sobre eventos que se producen en líneas y direcciones. Es posible que una aplicación no esté interesada en recibir todos los mensajes de cambio de dirección y estado de línea. La función lineSetStatusMessages se puede usar para seleccionar los mensajes que recibe la aplicación. De forma predeterminada, los informes de estado de la dirección y la línea están deshabilitados.