funzione TSPI_lineDrop (tspi.h)

Articolo
08/26/2023

La funzione TSPI_lineDrop elimina o disconnette la chiamata specificata. Le informazioni utente possono essere trasmesse facoltativamente come parte della disconnessione della chiamata. Questa funzione può essere chiamata dall'applicazione in qualsiasi momento. Quando TSPI_lineDrop restituisce, la chiamata deve essere inattiva.

Sintassi

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle del provider di servizi per la chiamata da eliminare. Lo stato della chiamata di hdCall può essere qualsiasi stato, ad eccezione dell'inattività.

lpsUserUserInfo

Questo puntatore è valido solo se dwSize è diverso da zero. Specifica un puntatore a una stringa con terminazione null contenente le informazioni sull'utente da inviare alla parte remota come parte della disconnessione della chiamata. Questo puntatore è NULL se non devono essere inviate informazioni utente.This pointer is NULL if not user-user information to be sent. Le informazioni sull'utente vengono inviate solo se supportate dalla rete sottostante (vedere LINEDEVCAPS).

dwSize

Dimensioni in byte delle informazioni utente in lpsUserUserInfo. Se lpsUserUserInfo è NULL, dwSize viene ignorato.

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_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Commenti

Il provider di servizi restituisce LINEERR_INVALCALLSTATE se lo stato corrente della chiamata non consente l'eliminazione della chiamata.

Quando si richiama TSPI_lineDrop, le chiamate correlate possono talvolta essere interessate. Ad esempio, l'eliminazione di una chiamata alla conferenza può eliminare tutte le singole chiamate che partecipano. LINE_CALLSTATE messaggi vengono inviati a TAPI per tutte le chiamate il cui stato di chiamata è interessato. In genere, una chiamata eliminata passa allo stato inattivo . Richiamando TSPI_lineDrop su una chiamata nello stato dell'offerta rifiuta la chiamata. Non tutte le reti telefoniche forniscono questa funzionalità.

In situazioni in cui la chiamata da eliminare è una chiamata di consultazione stabilita durante il trasferimento o l'istituzione della conferenza, la chiamata originale che è stata inserita nello stato OnHoldPending viene riconnessa e in genere entra nuovamente nello stato della chiamata connessa .

TAPI ha l'opzione per inviare le informazioni utente al momento dell'eliminazione. Anche se le informazioni utente possono essere inviate, non vi è alcuna garanzia che la rete distribuirà queste informazioni alla parte remota.

Nota In varie configurazioni della linea bridged o party quando più parti si trovano nella chiamata, TSPI_lineDrop potrebbe non cancellare effettivamente la chiamata.