lineGetLineDevStatusW-Funktion (tapi.h)

Mit der Funktion lineGetLineDevStatus kann eine Anwendung das angegebene Open Line-Gerät nach seiner aktuellen status abfragen.

Syntax

LONG lineGetLineDevStatusW(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

Parameter

hLine

Behandeln Sie das abzufragte Open Line-Gerät.

lpLineDevStatus

Zeiger auf eine datenvariable Größe vom Typ LINEDEVSTATUS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit dem gerätespezifischen status der Zeile gefüllt. Vor dem Aufrufen von lineGetLineDevStatus sollte die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, der TAPI für die Rückgabe 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 Zeilengerät nach seiner aktuellen Zeilen-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

Referenz zu Grundlegenden Telefoniediensten

LINEDEVSTATUS

ÜBERSICHT ÜBER TAPI 2.2-Referenz

lineGetAddressStatus