funzione lineAccept (tapi.h)

Articolo
03/09/2024

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

Sintassi

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

Parametri

hCall

Gestire la chiamata da accettare. L'applicazione deve essere un proprietario della chiamata. Lo stato di chiamata di hCall deve essere offerta.

lpsUserUserInfo

Puntatore a una stringa con terminazione null contenente le informazioni utente da inviare alla parte remota come parte dell'accettazione della chiamata. Questo puntatore può essere lasciato NULL se non devono essere inviate informazioni sull'utente. Le informazioni sull'utente vengono inviate solo se supportate dalla rete sottostante (vedere LINEDEVCAPS). Se necessario, il membro di discriminazione del protocollo per le informazioni sull'utente deve essere visualizzato come primo byte del buffer a cui punta lpsUserUserInfo e deve essere utilizzato in dwSize.

dwSize

Dimensioni delle informazioni utente in lpsUserUserInfo (incluso il terminatore Null ), in byte. Se lpsUserUserInfo è NULL, non vengono inviate informazioni utente all'entità chiamante e dwSize viene ignorato.

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 oppure è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

La funzione lineAccept viene usata negli ambienti di telefonia come Integrated Services Digital Network (ISDN) che consentono l'invio di avvisi associati alle chiamate in ingresso da separare dall'offerta iniziale della chiamata. Quando viene fornita una chiamata, viene prima offerta. Per un periodo di tempo limitato, l'applicazione può avere l'opzione di rifiutare la chiamata usando lineDrop, reindirizzare la chiamata a un'altra stazione usando lineRedirect, rispondere alla chiamata usando lineAnswer o accettare la chiamata usando lineAccept. Dopo che una chiamata è stata accettata correttamente da un'applicazione, l'avviso inizia con il dispositivo chiamato e chiamante e lo stato della chiamata in genere passa a accettato.

L'avviso viene segnalato all'applicazione dal messaggio LINE_LINEDEVSTATE con l'indicazione di anello .

La funzione lineAccept può essere supportata anche dai provider di servizi non ISDN. La transizione dello stato della chiamata a accettata può essere usata da altre applicazioni come indicazione che un'altra applicazione ha richiesto la responsabilità della chiamata e ha presentato la chiamata all'utente.

L'applicazione ha la possibilità di inviare informazioni utente al momento dell'accettazione. Anche se le informazioni sull'utente vengono inviate, non vi è alcuna garanzia che la rete distribuirà queste informazioni alla parte chiamante. Un'applicazione deve consultare le funzionalità del dispositivo di una riga per determinare se l'accettazione delle chiamate è disponibile.