lineGetLineDevStatus-Funktion (tapi.h)

Artikel
03/04/2024

Die lineGetLineDevStatus-Funktion ermöglicht es einer Anwendung, das angegebene Open Line-Gerät nach seiner aktuellen status abzufragen.

Syntax

LONG lineGetLineDevStatus(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

Parameter

hLine

Handle für das abzufragte Open Line-Gerät.

lpLineDevStatus

Zeiger auf eine Datenstruktur mit unterschiedlicher Größe vom Typ LINEDEVSTATUS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit dem gerätespezifischen status der Leitung gefüllt. Vor dem Aufrufen von lineGetLineDevStatus sollte die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

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_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Hinweise

Eine Anwendung verwendet lineGetLineDevStatus, um das Leitungsgerät nach seiner aktuellen Zeile status abzufragen. Diese status Informationen gelten global für alle Adressen auf dem Leitungsgerät. Verwenden Sie lineGetAddressStatus, um status Informationen zu einer bestimmten Adresse in einer Zeile zu ermitteln.