funzione lineRegisterRequestRecipient (tapi.h)

Articolo
03/02/2024

La funzione lineRegisterRequestRecipient registra l'applicazione richiamata come destinatario delle richieste per la modalità richiesta specificata.

Sintassi

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

Parametri

hLineApp

Handle di utilizzo dell'applicazione per la parte riga di TAPI.

dwRegistrationInstance

DWORD specifico dell'applicazione passato come parametro del messaggio di LINE_REQUEST. Questo messaggio notifica all'applicazione che una richiesta è in sospeso. Questo parametro viene ignorato se bEnable è impostato su zero. Questo parametro viene esaminato solo da TAPI per la registrazione, non per la registrazione. Il valore dwRegistrationInstance usato durante la registrazione non deve corrispondere alla dwRegistrationInstance usata durante la registrazione per una modalità richiesta.

dwRequestMode

Tipo di richiesta per cui l'applicazione registra. Questo parametro usa una o più costanti LINEREQUESTMODE_.

bEnable

Se TRUE, l'applicazione registra le modalità di richiesta specificate; se FALSE, l'applicazione deregisters per le modalità di richiesta specificate.

Valore restituito

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

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Commenti

Un'applicazione abilitata per la telefonia può richiedere che una chiamata venga inserita per conto dell'utente richiamando tapiRequestMakeCall. Inoltre, altre applicazioni possono richiedere che le informazioni vengano registrate con una chiamata specificata. Le richieste tapiRequestMakeCall vengono accodate da TAPI e l'applicazione con priorità più alta registrata per gestire la richiesta viene inviato un messaggio LINE_REQUEST con un'indicazione della modalità della richiesta in sospeso. Questa applicazione è in genere l'applicazione call-control dell'utente.

Successivamente, l'applicazione call-control che riceve questo messaggio richiama lineGetRequest, specificando la modalità richiesta e un buffer sufficientemente grande per contenere la richiesta. L'applicazione di controllo chiamate interpreta quindi ed esegue la richiesta.

L'applicazione destinatario viene inoltre annullata automaticamente per tutte le richieste quando esegue una rigaShutdown.