lineGetCallInfo-Funktion (tapi.h)

Artikel
03/02/2024

Die lineGetCallInfo-Funktion ermöglicht es einer Anwendung, feste Informationen über den angegebenen Aufruf abzurufen.

Syntax

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Parameter

hCall

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

lpCallInfo

Zeiger auf eine datenvariable Größe vom Typ LINECALLINFO. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit anrufbezogenen Informationen gefüllt. Vor dem Aufrufen von lineGetCallInfo 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_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Hinweise

Für jeden eingehenden oder ausgehenden Anruf ist eine separate LINECALLINFO-Struktur vorhanden. Die Struktur enthält in erster Linie feste Informationen zum Aufruf. Eine Anwendung ist in der Regel daran interessiert, diese Informationen zu überprüfen, wenn sie ihr Handle für einen Anruf von der LINE_CALLSTATE-Nachricht empfängt, oder jedes Mal, wenn sie eine Benachrichtigung durch eine LINE_CALLINFO Nachricht empfängt, dass Sich Teile der Anrufinformationsstruktur geändert haben. Diese Nachrichten stellen das Handle für den Aufruf als Parameter bereit.