lineSetStatusMessages-Funktion (tapi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |
Weitere Informationen
Referenz zu Grundlegenden Telefoniediensten