messaggio di LINE_PROXYREQUEST
Il messaggio TAPI LINE_PROXYREQUEST recapita una richiesta a un gestore di funzioni proxy registrato.
Parametri
-
hDevice
-
Handle dell'applicazione nel dispositivo line in cui è stato modificato lo stato dell'agente.
-
dwCallbackInstance
-
Istanza di callback specificata all'apertura della riga della chiamata.
-
dwParam1
-
Puntatore a una struttura LINEPROXYREQUEST contenente la richiesta da elaborare dall'applicazione del gestore proxy.
-
dwParam2
-
Riservato.
-
dwParam3
-
Riservato.
Valore restituito
Nessun valore restituito.
Commenti
Il messaggio LINE_PROXYREQUEST viene inviato solo alla prima applicazione registrata per gestire le richieste proxy del tipo recapitato.
L'applicazione deve elaborare la richiesta contenuta nel buffer proxy e chiamare lineProxyResponse per restituire dati o fornire risultati. L'elaborazione della richiesta deve essere eseguita nel contesto della funzione di callback TAPI dell'applicazione solo se può essere eseguita immediatamente, senza attendere la risposta da qualsiasi altra entità. Se l'applicazione deve comunicare con altre entità (ad esempio, un provider di servizi per gestire progettazione immagine e configurazione basata su PBX o qualsiasi altro servizio di sistema che potrebbe causare il blocco), la richiesta deve essere accodata all'interno dell'applicazione e la funzione di callback è stata chiusa per evitare di ritardare la ricezione di altri messaggi TAPI dall'applicazione.
Al momento in cui il LINE_PROXYREQUEST viene recapitato al gestore proxy, TAPI ha già restituito un risultato positivo della funzione dwRequestID all'applicazione originale e ha sbloccato il thread chiamante per continuare l'esecuzione. L'applicazione è in attesa di un messaggio LINE_REPLY , che viene generato automaticamente quando l'applicazione del gestore proxy chiama lineProxyResponse.
L'applicazione non libera la memoria a cui punta lpProxyRequest. TAPI libera la memoria durante l'esecuzione di lineProxyResponse. L'applicazione può chiamare lineProxyResponse esattamente una volta per ogni messaggio di LINE_PROXYREQUEST .
Se l'applicazione riceve un messaggio di LINE_CLOSE mentre ha richieste proxy in sospeso, deve chiamare lineProxyResponse per ogni richiesta in sospeso, passando un valore dwResult appropriato (ad esempio LINEERR_OPERATIONFAILED).
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|