funzione TSPI_lineCompleteCall (tspi.h)

Articolo
03/09/2024

La funzione TSPI_lineCompleteCall viene usata per specificare la modalità di completamento di una chiamata che normalmente non può essere connessa. La rete o il commutatore potrebbero non essere in grado di completare una chiamata perché le risorse di rete sono occupato o la stazione remota è occupato o non risponde.

Sintassi

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle del provider di servizi alla chiamata il cui completamento è richiesto. Lo stato della chiamata di hdCall può essere occupato, ringback o procedere.

lpdwCompletionID

Puntatore a un percorso di memoria di dimensioni DWORD in cui il provider di servizi scrive un identificatore di completamento. In modo univoco viene identificata una richiesta di completamento in corso nella riga contenente hdCall. In particolare, un identificatore di completamento diventa non valido dopo il completamento della richiesta o viene annullato usando la funzione TSPI_lineUncompleteCall . Il provider di servizi è libero di riutilizzare l'identificatore di completamento non appena diventa non valido.

dwCompletionMode

Modo in cui la chiamata deve essere completata. Questo parametro usa una e solo una delle costanti LINECALLCOMPLMODE_.

dwMessageID

Messaggio da inviare quando si completa la chiamata usando LINECALLCOMPLMODE_MESSAGE. Questo identificatore seleziona il messaggio da un numero ridotto di messaggi predefiniti. Questo parametro non viene convalidato da TAPI quando questa funzione viene chiamata.

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_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLCOMPLMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_COMPLETIONOVERRUN, LINEERR_INVALMESSAGEID.

Commenti

Questa funzione viene considerata completa quando la richiesta viene accettata dalla rete o dal commutatore; non quando la richiesta viene completata completamente nel modo specificato. Quando la stazione o la rete chiamata entra in uno stato in cui è possibile completare la chiamata come richiesto, il provider di servizi deve inviare un messaggio LINE_CALLSTATE con lo stato della chiamata uguale all'offerta. Il record LINECALLINFO della chiamata elenca anche il motivo della chiamata come CALLCOMPLETION e fornisce anche l'identificatore di completamento. È possibile avere più richieste di completamento delle chiamate in sospeso in qualsiasi momento; il numero massimo dipende dal dispositivo. L'identificatore di completamento viene usato anche per fare riferimento a ogni singola richiesta in modo che le richieste possano essere annullate chiamando TSPI_lineUncompleteCall.