Funzione lineGetNumRings (tapi.h)

La funzione lineGetNumRings determina il numero di anelli che devono chiamare una chiamata in ingresso sull'indirizzo specificato prima di rispondere alla chiamata.

Sintassi

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

Parametri

hLine

Handle per il dispositivo a riga aperta.

dwAddressID

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

lpdwNumRings

Numero di anelli minimo di tutte le richieste lineSetNumRing s correnti.

Valore restituito

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

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

Osservazioni

Le lineGetNumRings e funzioni lineSetNumRings, se usate in combinazione, forniscono un meccanismo per supportare l'implementazione di funzionalità di risparmio a pagamento in più applicazioni indipendenti.

Un'applicazione che riceve un handle per una chiamata nello stato che offre e un messaggio LINE_LINEDEVSTATEsquillo deve attendere un numero di anelli uguale al numero restituito da lineGetNumRings prima di rispondere alla chiamata per rispettare le impostazioni di risparmio a pagamento in tutte le applicazioni. La funzione lineGetNumRings restituisce il numero minimo di anelli specificati da lineSetNumRings. Poiché questo numero può variare in modo dinamico, un'applicazione deve richiamare lineGetNumRings ogni volta che ha la possibilità di rispondere a una chiamata. Se nessuna applicazione ha chiamato lineSetNumRings, il numero di anelli restituiti è 0xFFFFFFFF. All'applicazione viene inviato un messaggio di LINE_LINEDEVSTATE squillo separato per ogni ciclo circolare.

Se la classificazione delle chiamate viene eseguita da TAPI per rispondere a tutte le chiamate di modalità multimediale sconosciuta e filtrare il flusso multimediale, TAPI rispetta anche questo numero.

Fabbisogno

Vedere anche

di riferimento dei servizi di telefonia di base

LINE_LINEDEVSTATE

panoramica dei riferimenti TAPI 2.2

lineSetNumRings