función TSPI_lineSetStatusMessages (tspi.h)
La función TSPI_lineSetStatusMessages permite a TAPI especificar qué mensajes de notificación debe generar el proveedor de servicios para eventos relacionados con los cambios de estado de la línea especificada o cualquiera de sus direcciones.
Sintaxis
LONG TSPIAPI TSPI_lineSetStatusMessages(
HDRVLINE hdLine,
DWORD dwLineStates,
DWORD dwAddressStates
);
Parámetros
hdLine
Identificador del dispositivo de línea para el que se va a establecer el nuevo filtro.
dwLineStates
Matriz de bits que identifica para qué estado del dispositivo de línea cambia un mensaje se va a enviar a TAPI. Este parámetro usa una de las constantes LINEDEVSTATE_.
dwAddressStates
Matriz de bits que identifica para qué estado de dirección cambia un mensaje se va a enviar a TAPI. Este parámetro usa una de las constantes LINEADDRESSSTATE_.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINESTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Comentarios
El proveedor de servicios devuelve LINEERR_INVALLINESTATE si el parámetro dwLineStates contiene uno o varios bits que no son constantes LINEDEVSTATE_.
La telefonía define una serie de mensajes que notifican a las aplicaciones sobre eventos que se producen en líneas y direcciones. Los conjuntos de todos los mensajes de cambio en los que todas las aplicaciones están interesadas pueden ser mucho más pequeñas que el conjunto de posibles mensajes. Este procedimiento permite que TAPI indique al proveedor de servicios el conjunto reducido de mensajes que se van a entregar. El proveedor de servicios entrega todos los mensajes que admite, dentro del conjunto especificado. Se permite entregar más (se filtran por TAPI), pero no se recomienda hacerlo por motivos de rendimiento. Si TAPI solicita la entrega de un tipo de mensaje determinado que el proveedor no genera, el proveedor acepta la solicitud, pero simplemente no genera el mensaje. De forma predeterminada, los informes de estado de dirección y línea están deshabilitados inicialmente para una línea.
Esta función difiere de la función TAPI correspondiente de la siguiente manera: (1) El conjunto de mensajes solicitado es la unión de todos los conjuntos solicitados por las aplicaciones en el nivel TAPI. (2) El conjunto de mensajes no se reduce ni aumenta por la propiedad (porque no hay ningún concepto de propiedad en el nivel de TSPI) (3) El conjunto es asesor en el sentido de que el proveedor de servicios es necesario reenviar al menos el conjunto de mensajes indicado, pero se permite reenviar un conjunto mayor.
Los cambios de estado del dispositivo con respecto a Open y Close no se notifican, ya que en el nivel de TSPI solo hay una apertura pendiente a la vez.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |