Funzione lineSendUserUserInfo (tapi.h)

Articolo
03/08/2023

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

Sintassi

LONG lineSendUserUserInfo(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parametri

hCall

Gestire la chiamata su cui inviare informazioni utente-utente. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall deve essere connesso, offrendo, accettato o ringback.

lpsUserUserInfo

Puntatore a una stringa contenente le informazioni utente da inviare all'entità remota. Le informazioni utente vengono inviate solo se supportate dalla rete sottostante (vedere LINEDEVCAPS). Il campo discriminatorio del protocollo per le informazioni utente-utente, se necessario, deve essere visualizzato come primo byte del buffer a cui punta lpsUserUserInfo e deve essere tenuto conto di in dwSize.

dwSize

Dimensioni in byte delle informazioni utente-utente in lpsUserUserInfo.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

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 della divisione delle informazioni in una sequenza di messaggi di rete concatenati (utilizzando "più dati").

Le informazioni utente-utente possono anche essere inviate come parte dell'accettazione della chiamata, rifiuto di chiamata e reindirizzamento delle chiamate e durante l'esecuzione di chiamate. È anche possibile ricevere informazioni utente.User-user information can be received. Le informazioni ricevute sono disponibili tramite il record di informazioni sulle chiamate della chiamata. Ogni volta che arrivano informazioni sull'utente dopo l'offerta di chiamata o prima della disconnessione della chiamata, un messaggio di LINE_CALLINFO con un parametro UserUserInfo notifica all'applicazione che le informazioni utente-utente nel record delle informazioni di chiamata sono state modificate. Se più messaggi di rete vengono concatenati, le informazioni vengono assemblate dal provider di servizi e viene inviato un singolo messaggio all'applicazione.

Questa funzione può inviare dati in transito in formato non crittografato; pertanto, un utente che esegue l'intercettazione sulla rete potrebbe essere in grado di leggere i dati. Il rischio di sicurezza di inviare i dati in testo non crittografato deve essere considerato prima di usare questo metodo.