Funzione lineSetNumRings (tapi.h)

Articolo
03/02/2024

La funzione lineSetNumRings imposta il numero di anelli che devono verificarsi prima della risposta di una chiamata in arrivo. Questa funzione può essere usata per implementare una funzione di tipo toll-saver. Consente a più applicazioni indipendenti di registrare il numero di anelli. La funzione lineGetNumRings restituisce il numero minimo di anelli richiesti. Può essere usato dall'applicazione che risponde alle chiamate in arrivo per determinare il numero di anelli che deve attendere prima di rispondere alla chiamata.

Sintassi

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

Parametri

hLine

Handle per il dispositivo a riga aperta.

dwAddressID

Indirizzo sul dispositivo line. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwNumRings

Numero di anelli prima di rispondere a una chiamata per rispettare le richieste di pagamento a pagamento da tutte le applicazioni.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Commenti

Le funzioni lineGetNumRings e lineSetNumRings , se usate in combinazione, forniscono un meccanismo per supportare l'implementazione di funzionalità di risparmio a pagamento in più applicazioni indipendenti. Se nessuna applicazione chiama mai lineSetNumRings, lineGetNumRings restituisce 0xFFFFFFFF.

Un'applicazione che è il proprietario di una chiamata nello stato dell'offerta e che ha ricevuto un messaggio di squillo LINE_LINEDEVSTATE deve attendere un numero di anelli uguale al numero restituito da lineGetNumRings prima di rispondere alla chiamata per rispettare le impostazioni del risparmio a pagamento in tutte le applicazioni. All'applicazione viene inviato un messaggio di squillo LINE_LINEDEVSTATE separato per ogni ciclo circolare, quindi l'applicazione deve contare questi messaggi. Se questa chiamata si disconnette prima della risposta e un'altra chiamata arriva poco dopo, il messaggio LINE_CALLSTATE deve consentire all'applicazione di determinare che l'anello è correlato alla seconda chiamata.

Se la classificazione delle chiamate viene eseguita da TAPI per rispondere alle chiamate in ingresso di tipo multimediale sconosciuto e filtrare il flusso multimediale, TAPI rispetta anche questo numero.

Nota Questa operazione è puramente informativa e non influisce sullo stato delle chiamate sul dispositivo line.