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