Funzione lineAnswer (tapi.h)

Articolo
08/26/2023

La funzione lineAnswer risponde alla chiamata di offerta specificata.

Sintassi

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

Parametri

hCall

Gestire la chiamata a cui rispondere. L'applicazione deve essere un proprietario di questa chiamata. Lo stato della chiamata di hCall deve essere offerto o accettato.

lpsUserUserInfo

Puntatore a una stringa con terminazione Null contenente informazioni utente-utente da inviare all'entità remota al momento della risposta alla chiamata. Questo puntatore può essere lasciato NULL se non devono essere inviate informazioni utente.This pointer can be left NULL if no user-user information is to be sent. 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 delle informazioni utente-utente in lpsUserUserInfo (incluso il carattere di terminazione Null ), in byte Se lpsUserUserInfo è NULL, nessuna informazione utente viene inviata alla parte chiamante e dwSize viene ignorata.

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_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG LINEERR_NOTOWNER.

Commenti

Quando arriva una nuova chiamata, le applicazioni con interesse nella chiamata vengono inviate un messaggio di LINE_CALLSTATE per fornire il nuovo handle di chiamata e per informare l'applicazione sullo stato della chiamata e i privilegi per la nuova chiamata (ad esempio monitoraggio o proprietario). L'applicazione con privilegi di proprietario per la chiamata può rispondere a questa chiamata usando lineAnswer. Dopo la risposta della chiamata, la chiamata passa in genere allo stato connesso . Inizialmente, alla chiamata in ingresso viene assegnato un solo privilegio di proprietario.

In alcuni ambienti di telefonia (ad esempio ISDN), in cui gli avvisi degli utenti sono separati dall'offerta di chiamata, l'applicazione può scegliere di accettare una chiamata prima di rispondere o rifiutare o reindirizzare la chiamata all'offerta.

Se viene visualizzata una chiamata (viene offerta) al momento in cui un'altra chiamata è già attiva, richiamare lineAnswer si connette alla nuova chiamata. L'effetto che ha sulla chiamata attiva esistente dipende dalle funzionalità del dispositivo della riga. La prima chiamata può essere influenzata, può essere eliminata automaticamente oppure può essere messa automaticamente in attesa. I messaggi di LINE_CALLSTATE appropriati segnalano le transizioni di stato all'applicazione su entrambe le chiamate.

In una situazione bridged, se una chiamata è connessa ma nello stato LINECONNECTEDMODE_INACTIVE, può essere unita tramite la funzione lineAnswer .

L'applicazione ha la possibilità di inviare informazioni utente-utente al momento della risposta. Anche se è possibile inviare informazioni sull'utente, non vi è alcuna garanzia che la rete consegni queste informazioni alla parte chiamante. Un'applicazione deve consultare le funzionalità del dispositivo di una riga per determinare se l'invio di informazioni utente-utente al momento della risposta alla chiamata è disponibile.