TSPI_lineHold-Funktion (tspi.h)
Die TSPI_lineHold-Funktion setzt den angegebenen Aufruf in den Halteraum.
Syntax
LONG TSPIAPI TSPI_lineHold(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle des Dienstanbieters für den Anruf, der im Haltepunkt platziert werden soll. Der Anrufstatus von hdCall kann verbunden werden.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Der Anruf wird vorübergehend getrennt, sodass TAPI das Leitungsgerät zum Tätigen oder Annehmen anderer Anrufe verwenden kann. TSPI_lineHold führt den angegebenen Anruf im Gegensatz zu einem Konsultationsgesprächhart durch. Ein Anruf im Festhalteraum kann in der Regel nicht übertragen oder in eine Telefonkonferenz einbezogen werden, während ein Beratungsgespräch dies tun kann. Konsultationsaufrufe werden über TSPI_lineSetupTransfer, TSPI_lineSetupConference oder TSPI_linePrepareAddToConference initiiert.
Nachdem ein Aufruf erfolgreich im Haltezustand platziert wurde, wechselt der Aufrufzustand in der Regel in onHold. Ein gehaltener Anruf wird über TSPI_lineUnhold abgerufen. Während sich ein Anruf im Haltezustand befindet, kann der Dienstanbieter LINE_CALLSTATE Nachrichten zu Zustandsänderungen des gehaltenen Anrufs senden. Wenn z. B. die gehaltene Partei aufhängt, kann der Anrufstatus in getrennt übergehen, und der Dienstanbieter kann eine LINE_CALLSTATE Nachricht senden, die den neuen Zustand angibt.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |