TSPI_lineSetStatusMessages-Funktion (tspi.h)

Artikel
08/26/2023

Mit der funktion TSPI_lineSetStatusMessages kann TAPI angeben, welche Benachrichtigungen der Dienstanbieter für Ereignisse im Zusammenhang mit status Änderungen für die angegebene Zeile oder eine ihrer Adressen generieren soll.

Syntax

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

Parameter

hdLine

Das Ziehpunkt für das Leitungsgerät, für das der neue Filter festgelegt werden soll.

dwLineStates

Ein Bitarray, das angibt, für welches Leitungsgerät status Änderungen eine Nachricht an TAPI gesendet werden soll. Dieser Parameter verwendet eine der LINEDEVSTATE_ Konstanten.

dwAddressStates

Ein Bitarray, das angibt, für welche Adresse status Änderungen eine Nachricht an TAPI gesendet werden soll. Dieser Parameter verwendet eine der LINEADDRESSSTATE_ Konstanten.

Rückgabewert

Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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

Hinweise

Der Dienstanbieter gibt LINEERR_INVALLINESTATE zurück, wenn der dwLineStates-Parameter ein oder mehrere Bits enthält, die nicht LINEDEVSTATE_ Konstanten sind.

Telefonie definiert eine Reihe von Nachrichten, die Anwendungen über Ereignisse in Leitungen und Adressen benachrichtigen. Die Sätze aller Änderungsmeldungen, an denen alle Anwendungen interessiert sind, können viel kleiner sein als der Satz möglicher Nachrichten. Mit diesem Verfahren kann TAPI dem Dienstanbieter den reduzierten Satz von Nachrichten mitteilen, die übermittelt werden sollen. Der Dienstanbieter übermittelt alle unterstützten Nachrichten innerhalb des angegebenen Satzes. Es ist erlaubt, mehr zu liefern (sie werden von TAPI herausgefiltert), wird aber aus Leistungsgründen davon abgeraten. Wenn TAPI die Übermittlung eines bestimmten Nachrichtentyps anfordert, der nicht vom Anbieter erstellt wird, nimmt der Anbieter die Anforderung zwar an, erzeugt aber einfach nicht die Nachricht. Standardmäßig ist die Berichterstellung für Adressen und Zeilen status für eine Zeile zunächst deaktiviert.

Diese Funktion unterscheidet sich von der entsprechenden TAPI-Funktion wie folgt: (1) Der angeforderte Nachrichtensatz ist die Vereinigung aller Sätze, die von Anwendungen auf TAPI-Ebene angefordert werden. (2) Der Nachrichtensatz wird weder reduziert noch um den Besitz erweitert (da es kein Konzept des Besitzes auf TSPI-Ebene gibt) (3) Der Satz ist in dem Sinne eine Empfehlung, dass der Dienstanbieter verpflichtet ist, mindestens den angegebenen Satz von Nachrichten weiterzuleiten, aber eine größere Menge weiterzuleiten.

Gerätezustandsänderungen in Bezug auf Öffnen und Schließen werden nicht gemeldet, da auf TSPI-Ebene jeweils nur ein ausstehendes Open-Objekt vorhanden ist.