lineHold-Funktion (tapi.h)

Artikel
03/02/2024

Die lineHold-Funktion legt den angegebenen Aufruf in die Warteschleife.

Syntax

LONG lineHold(
  HCALL hCall
);

Parameter

hCall

Handle mit dem Aufruf, der in der Warteschleife platziert werden soll. Die Anwendung muss besitzer des Aufrufs sein. Der Anrufstatus von hCall muss verbunden 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 0, 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

Der Anruf im Warteschleifen wird vorübergehend getrennt, sodass die Anwendung das Leitungsgerät zum Tätigen oder Annehmen anderer Anrufe verwenden kann. Die lineHold-Funktion führt einen sogenannten "Hard Hold" des angegebenen Aufrufs aus (im Gegensatz zu einem "Konsultationsaufruf"). Ein Anruf in harter Warteschleife kann in der Regel nicht übertragen oder in eine Telefonkonferenz einbezogen werden, aber ein Beratungsgespräch kann dies. Konsultationsaufrufe werden mithilfe von lineSetupTransfer, lineSetupConference oder linePrepareAddToConference initiiert.

Nachdem ein Aufruf erfolgreich in die Warteschleife gesetzt wurde, wechselt der Anrufzustand in der Regel zu onHold. Ein gehaltener Aufruf wird von lineUnhold abgerufen. Während sich ein Anruf in der Warteschleife befindet, kann die Anwendung LINE_CALLSTATE Nachrichten über Zustandsänderungen des gehaltenen Anrufs empfangen. Wenn die gehaltene Partei beispielsweise aufhängt, kann der Anrufstatus in getrennt übergehen.

In einer überbrückten Situation kann ein lineHold-Vorgang den Anruf möglicherweise nicht tatsächlich in die Warteschleife versetzen, da die status anderer Stationen des Anrufs steuern kann (z. B. ist der Versuch, einen Anruf zu "halten", wenn andere Stationen teilnehmen, nicht möglich). Stattdessen kann der Anruf einfach in den LINECONNECTEDMODE_INACTIVE Modus geändert werden, wenn er an anderen Stationen verbunden bleibt.