LINE_PROXYREQUEST Nachricht
Die TAPI-LINE_PROXYREQUEST-Nachricht sendet eine Anforderung an einen registrierten Proxyfunktionshandler.
Parameter
-
hGeräte
-
Das Handle der Anwendung für das Zeilengerät, auf dem sich der Agent status geändert hat.
-
dwCallbackInstance
-
Der Rückruf instance beim Öffnen der Anrufzeile angegeben.
-
dwParam1
-
Zeiger auf eine LINEPROXYREQUEST-Struktur , die die Anforderung enthält, die von der Proxyhandleranwendung verarbeitet werden soll.
-
dwParam2
-
Reserviert.
-
dwParam3
-
Reserviert.
Rückgabewert
Kein Rückgabewert.
Bemerkungen
Die LINE_PROXYREQUEST Nachricht wird nur an die erste Anwendung gesendet, die sich registriert hat, um Proxyanforderungen des zu übermittelnden Typs zu verarbeiten.
Die Anwendung sollte die im Proxypuffer enthaltene Anforderung verarbeiten und lineProxyResponse aufrufen, um Daten zurückzugeben oder Ergebnisse zu liefern. Die Verarbeitung der Anforderung sollte nur im Kontext der TAPI-Rückruffunktion der Anwendung erfolgen, wenn sie sofort ausgeführt werden kann, ohne auf eine Antwort von einer anderen Entität zu warten. Wenn die Anwendung mit anderen Entitäten kommunizieren muss (z. B. einem Dienstanbieter für die Verarbeitung von PBX-basierten ACD oder einem anderen Systemdienst, der zu einer Blockierung führen kann), sollte die Anforderung in die Warteschlange in der Anwendung gestellt und die Rückruffunktion beendet werden, um den Empfang weiterer TAPI-Nachrichten durch die Anwendung zu vermeiden.
Zu dem Zeitpunkt, zu dem die LINE_PROXYREQUEST an den Proxyhandler übermittelt wird, hat TAPI bereits ein positives dwRequestID-Funktionsergebnis an die ursprüngliche Anwendung zurückgegeben und die Blockierung des aufrufenden Threads aufgehoben, um die Ausführung fortzusetzen. Die Anwendung wartet auf eine LINE_REPLY-Nachricht , die automatisch generiert wird, wenn die Proxyhandleranwendung lineProxyResponse aufruft.
Die Anwendung darf den Speicher, auf den lpProxyRequest verweist, nicht freigeben. TAPI gibt den Arbeitsspeicher während der Ausführung von lineProxyResponse frei. Die Anwendung kann lineProxyResponse für jede LINE_PROXYREQUEST Nachricht genau einmal aufrufen.
Wenn die Anwendung eine LINE_CLOSE Nachricht empfängt, während sie ausstehende Proxyanforderungen enthält, sollte sie lineProxyResponse für jede ausstehende Anforderung aufrufen und einen entsprechenden dwResult-Wert (z. B. LINEERR_OPERATIONFAILED) übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|