funzione TSPI_lineCloseCall (tspi.h)

La funzione TSPI_lineCloseCall dealloca la chiamata dopo il completamento o l'interruzione di tutte le operazioni asincrone in sospeso sulla chiamata.

Sintassi

LONG TSPIAPI TSPI_lineCloseCall(
  HDRVCALL hdCall
);

Parametri

hdCall

Handle del provider di servizi per la chiamata da chiudere. Dopo la chiusura della chiamata, l'handle non è più valido. Lo stato della chiamata può essere qualsiasi stato.

Valore restituito

Restituisce 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_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.

Commenti

Il provider di servizi deve segnalare il completamento per le operazioni asincrone. Se TSPI_lineCloseCall viene chiamato per una chiamata su cui sono presenti operazioni asincrone in sospeso, è necessario segnalare che le operazioni devono essere completate con un risultato o un codice di errore appropriato prima che venga restituita questa procedura. Al termine di questa procedura, il provider di servizi non deve segnalare altri eventi nella chiamata. Gli handle del provider di servizi per la riga e le chiamate sulla riga diventano "non validi".

TAPI non chiama TSPI_lineCloseCall se un provider di servizi restituisce in modo sincrono un errore da una chiamata alla funzione TSPI_lineMakeCall . Ma TAPI chiama TSPI_lineCloseCall se il provider di servizi restituisce un errore dall'operazione asincrona avviata da TSPI_lineMakeCall.

Se è presente una chiamata attiva sulla riga al momento di TSPI_lineCloseCall, la chiamata deve essere eliminata se questo comportamento è indicato dal bit LINEDEVCAPFLAGS_CLOSEDROP nella struttura LINEDEVCAPS .

Se il provider di servizi può determinare che esiste un altro controllo di condivisione dell'agente della chiamata, ad esempio in una situazione di riga di entità con un handset separato, il provider di servizi consente semplicemente di controllare il passaggio della chiamata all'altro agente anziché eliminarlo forzatamente.

Questa funzione deve avere sempre esito positivo tranne in circostanze straordinarie. La maggior parte dei chiamanti probabilmente ignorerà il codice restituito perché non sarà in grado di compensare eventuali errori che si verificano. I valori restituiti specificati sono più consultivi per scopi di diagnostica di sviluppo rispetto a qualsiasi altro elemento.

Questa funzione viene chiamata quando l'ultima applicazione con un handle per questa chiamata esegue lineDeallocateCall.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

LINEDEVCAPS

TSPI_lineMakeCall