lineGetAddressStatusA-Funktion (tapi.h)

Mit der lineGetAddressStatus--Funktion kann eine Anwendung die angegebene Adresse nach ihrem aktuellen Status abfragen.

Syntax

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

Parameter

hLine

Behandeln des offenen Leitungsgeräts.

dwAddressID

Adresse auf dem angegebenen offenen Leitungsgerät. Dies ist die Adresse, die abgefragt werden soll. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.

lpAddressStatus

Zeiger auf eine variabel angepasste Datenstruktur vom Typ LINEADDRESSSTATUS. Vor dem Aufrufen lineGetAddressStatus-muss die Anwendung die dwTotalSize Mitglied dieser Struktur festlegen, um die Menge des arbeitsspeicher verfügbaren TAPI für die Rückgabe von Informationen anzugeben.

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

 

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, 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.

Bemerkungen

Anmerkung

Der header tapi.h definiert lineGetAddressStatus als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

Referenz zu grundlegenden Telefoniediensten

LINEADDRESSSTATUS-

TAPI 2.2 Referenzübersicht