funzione TSPI_lineSendUserUserInfo (tspi.h)

Articolo
08/26/2023

La funzione TSPI_lineSendUserUserInfo invia informazioni utente all'entità remota nella chiamata specificata.

Sintassi

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

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle per la chiamata su cui inviare informazioni utente. Lo stato della chiamata di hdCall può essere connesso, offerta, accettata o ringback.

lpsUserUserInfo

Puntatore a una stringa Unicode con terminazione null contenente le informazioni utente da inviare all'entità remota. Le informazioni sull'utente vengono inviate solo se supportate dalla rete sottostante (vedere LINEDEVCAPS).

dwSize

Dimensioni, in byte, tra cui il terminatore Null , delle informazioni sull'utente in lpsUserUserInfo.

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

Questa funzione può essere usata per inviare informazioni utente-utente in qualsiasi momento durante una chiamata connessa. Se le dimensioni delle informazioni specificate da inviare sono maggiori di quelle che possono essere inserite in un singolo messaggio di rete (come in ISDN), il provider di servizi è responsabile dell'interruzione delle informazioni in una sequenza di messaggi di rete concatenati (usando "più dati").

Le informazioni sull'utente possono essere inviate anche come parte dell'accettazione della chiamata, rifiuto di chiamata, reindirizzamento delle chiamate e durante l'esecuzione di chiamate. È anche possibile ricevere informazioni sull'utente. Le informazioni ricevute vengono segnalate nella struttura LINECALLINFO della chiamata. Ogni volta che le informazioni utente arrivano dopo l'offerta di chiamata o prima della disconnessione, un messaggio di LINE_CALLINFO con un parametro UserUserInfo notifica a TAPI che le informazioni utente nel record di informazioni sulle chiamate sono state modificate. Se vengono concatenati più messaggi di rete, le informazioni vengono assemblate dal provider di servizi e viene inviato un singolo messaggio a TAPI.