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	Tapi.h

Vedi anche

LINE_CLOSE

LINE_REPLY

LINEPROXYREQUEST

lineProxyResponse