funzione TSPI_lineHold (tspi.h)

Articolo
03/08/2023

La funzione TSPI_lineHold posiziona la chiamata specificata in attesa.

Sintassi

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle del provider di servizi per la chiamata da mettere in attesa. Lo stato della chiamata di hdCall può essere connesso.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

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

Commenti

La chiamata in attesa viene temporaneamente disconnessa, consentendo a TAPI di usare il dispositivo line per effettuare o rispondere ad altre chiamate. TSPI_lineHold esegue un blocco rigido della chiamata specificata, anziché una chiamata di consultazione. Una chiamata a dura attesa in genere non può essere trasferita o inclusa in una conferenza telefonica, mentre una chiamata di consultazione può. Le chiamate di consultazione vengono avviate utilizzando TSPI_lineSetupTransfer, TSPI_lineSetupConference o TSPI_linePrepareAddToConference.

Dopo che una chiamata è stata messa in attesa, lo stato della chiamata passa in genere a onHold. Una chiamata tenuta viene recuperata tramite TSPI_lineUnhold. Mentre una chiamata è in attesa, il provider di servizi può inviare LINE_CALLSTATE messaggi sulle modifiche dello stato della chiamata tenuta. Ad esempio, se la parte bloccata si blocca, lo stato della chiamata può passare a disconnesso e il provider di servizi può inviare un messaggio di LINE_CALLSTATE che indica il nuovo stato.