lineSetStatusMessages-Funktion (tapi.h)

Artikel
03/04/2024

Mit der lineSetStatusMessages-Funktion kann eine Anwendung angeben, welche Benachrichtigungen für Ereignisse im Zusammenhang mit status Änderungen für die angegebene Zeile oder eine ihrer Adressen empfangen werden sollen.

Syntax

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

Parameter

hLine

Handle mit dem Leitungsgerät.

dwLineStates

Bitarray, das identifiziert, für welche Zeilengeräte-status Änderungen eine Nachricht an die Anwendung gesendet werden soll. Dieser Parameter verwendet mindestens eine der LINEDEVSTATE_ Konstanten.

dwAddressStates

Bitarray, das identifiziert, für welche Adresse status eine Nachricht an die Anwendung gesendet werden soll. Dieser Parameter verwendet mindestens eine 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_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

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 empfängt. Standardmäßig ist die Adress- und Zeilen-status Berichterstellung deaktiviert.