funzione TSPI_lineAccept (tspi.h)

Articolo
08/26/2023

La funzione TSPI_lineAccept accetta la chiamata offerta specificata. Facoltativamente, può inviare le informazioni utente specificate all'entità chiamante.

Sintassi

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

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle della chiamata da accettare. Lo stato della chiamata di hdCall può essere offerto.

lpsUserUserInfo

Puntatore a una stringa Unicode con terminazione null contenente le informazioni utente da inviare alla parte remota come parte dell'accettazione 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 se la funzione viene completata in modo asincrono o un numero di errore se si verifica un errore. Il parametro 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

La funzione TSPI_lineAccept viene usata negli ambienti di telefonia (ad esempio ISDN) che consentono l'avviso associato alle chiamate in ingresso di essere separate dall'offerta iniziale della chiamata. Quando viene visualizzata una chiamata, la chiamata viene prima offerta. Per un periodo di tempo limitato, l'applicazione client può avere la possibilità di rifiutare la chiamata usando TSPI_lineDrop, reindirizzare la chiamata a un'altra stazione usando TSPI_lineRedirect, rispondere alla chiamata usando TSPI_lineAnswer o accettare la chiamata usando TSPI_lineAccept. Dopo che una chiamata è stata accettata correttamente, l'avviso in corrispondenza del dispositivo chiamato e chiamante inizia e in genere lo stato della chiamata passa allo stato accettato . Il provider di servizi deve impostare il flag LINEADDRCAPFLAGS_ACCEPTTOALERT nel membro dwAddrCapFlags della struttura di dati LINEADDRESSCAPS se l'applicazione deve chiamare TSPI_lineAccept per iniziare l'avviso.

Per TAPI, viene segnalato l'avviso usando il messaggio LINE_LINEDEVSTATE con l'indicazione di anello .

TSPI_lineAccept può essere supportato anche da provider di servizi NON ISDN. La transizione dello stato della chiamata allo stato accettato può essere usata da altri client TAPI come indicazione che alcune applicazioni hanno richiesto la responsabilità della chiamata e hanno presentato la chiamata all'utente.

L'applicazione client ha la possibilità di inviare informazioni utente al momento dell'accettazione. Anche se le informazioni utente possono essere inviate, spesso non vengono fornite garanzie che la rete distribuirà queste informazioni alla parte chiamante. L'applicazione client può consultare le funzionalità del dispositivo di una riga per determinare se l'accettazione delle chiamate è disponibile.