lineGetAddressStatus-Funktion (tapi.h)

  • Artikel

Mit der lineGetAddressStatus-Funktion kann eine Anwendung die angegebene Adresse für ihre aktuelle status abfragen.

Syntax

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Parameter

hLine

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

dwAddressID

Adresse auf dem angegebenen Open Line-Gerät. Dies ist die adresse, die abgefragt werden soll. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

lpAddressStatus

Zeiger auf eine Datenstruktur mit unterschiedlicher Größe vom Typ LINEADDRESSSTATUS. Vor dem Aufruf von lineGetAddressStatus muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema speicherbelegung .
 

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi.h
Bibliothek Tapi32.lib
DLL Tapi32.dll

Weitere Informationen

Grundlegende Referenz zu Telefoniediensten

LINEADDRESSSTATUS

ÜBERSICHT ÜBER TAPI 2.2-Referenz