lineSecureCall-Funktion (tapi.h)

Artikel
08/26/2023

Die lineSecureCall-Funktion schützt den Aufruf vor Unterbrechungen oder Störungen, die sich auf den Mediendatenstrom des Anrufs auswirken können.

Syntax

LONG lineSecureCall(
  HCALL hCall
);

Parameter

hCall

Handle für den zu sichernden Anruf. Die Anwendung muss ein Besitzer des Anrufs sein. Der Aufrufstatus von hCall kann ein beliebiger Zustand sein.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Hinweise

Ein Anruf kann gesichert werden, um Störungen zu vermeiden. In einer analogen Umgebung können z. B. wartenden Anrufen eine Fax- oder Modemsitzung beim ursprünglichen Anruf zerstören. Mit der lineSecureCall-Funktion kann ein vorhandener Aufruf gesichert werden. Die lineMakeCall-Funktion bietet die Möglichkeit, den Aufruf ab dem Zeitpunkt der Anrufeinrichtung zu sichern. Die Sicherung eines Anrufs bleibt für die Dauer des Anrufs wirksam.