lineGetStatusMessages-Funktion (tapi.h)

Artikel
03/02/2024

Mit der lineGetStatusMessages-Funktion kann eine Anwendung abfragen, welche Benachrichtigungen die Anwendung für Ereignisse im Zusammenhang mit status Änderungen für die angegebene Zeile oder eine ihrer Adressen empfängt.

Syntax

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

Parameter

hLine

Handle zum Leitungsgerät.

lpdwLineStates

Bitarray, das angibt, für welches Leitungsgerät status Änderungen eine Nachricht an die Anwendung gesendet werden soll. Wenn ein Flag TRUE ist, ist diese Meldung aktiviert. wenn FALSE, ist es deaktiviert. Dieser Parameter verwendet eine oder mehrere der LINEDEVSTATE_ Konstanten.

lpdwAddressStates

Bitarray, das angibt, für welche Adresse status Änderungen eine Nachricht an die Anwendung gesendet werden soll. Wenn ein Flag TRUE ist, ist diese Meldung aktiviert. , wenn FALSE, deaktiviert. Dieser Parameter verwendet eine oder mehrere der LINEADDRESSSTATE_ Konstanten.

Rückgabewert

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Hinweise

TAPI definiert eine Reihe von Nachrichten, die Anwendungen über Ereignisse in Zeilen und Adressen benachrichtigen. Eine Anwendung ist möglicherweise nicht daran interessiert, alle Adressen und Zeilen status Änderungsnachrichten zu empfangen. Die lineSetStatusMessages-Funktion kann verwendet werden, um auszuwählen, welche Nachrichten die Anwendung empfangen möchte. Standardmäßig sind die Status adressen und die Berichterstellung für zeilenspezifische status deaktiviert.