Función lineGetStatusMessages (tapi.h)

Artículo
03/02/2024

La función lineGetStatusMessages permite a una aplicación consultar los mensajes de notificación que la aplicación está configurada para recibir eventos relacionados con los cambios de estado de la línea especificada o cualquiera de sus direcciones.

Sintaxis

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

Parámetros

hLine

Identificador del dispositivo de línea.

lpdwLineStates

Matriz de bits que identifica para qué estado del dispositivo de línea cambia un mensaje se va a enviar a la aplicación. Si una marca es TRUE, ese mensaje está habilitado; si es FALSE, está deshabilitado. Este parámetro usa una o varias de las constantes de LINEDEVSTATE_.

lpdwAddressStates

Matriz de bits que identifica para qué estado de dirección cambia un mensaje se va a enviar a la aplicación. Si una marca es TRUE, ese mensaje está habilitado; si es FALSE, deshabilitado. 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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

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 qué mensajes quiere recibir la aplicación. De forma predeterminada, los informes de estado de dirección y estado de línea están deshabilitados.