lineGetCallStatus-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetCallStatus-Funktion gibt den aktuellen status des angegebenen Aufrufs zurück.

Syntax

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Parameter

hCall

Behandeln Sie den abzufragten Aufruf. Der Anrufstatus von hCall kann ein beliebiger Zustand sein.

lpCallStatus

Zeiger auf eine datenvariable Größe vom Typ LINECALLSTATUS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Aufrufinformationen status gefüllt. Vor dem Aufrufen von lineGetCallStatus muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, der 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 Speicherzuordnung .

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

Hinweise

Die funktion lineGetCallStatus gibt die dynamische status eines Aufrufs zurück, während lineGetCallInfo hauptsächlich statische Informationen zu einem Aufruf zurückgibt. Aufruf status Informationen umfassen den aktuellen Aufrufstatus, detaillierte Modusinformationen zum Aufruf in diesem Zustand (falls vorhanden) sowie eine Liste der verfügbaren API-Funktionen, die die Anwendung für den Aufruf aufrufen kann, während sich der Aufruf in diesem Zustand befindet. Eine Anwendung ist in der Regel daran interessiert, diese Informationen anzufordern, wenn sie Benachrichtigungen über eine Anrufstatusänderung durch die LINE_CALLSTATE-Nachricht empfängt.