lineProxyMessage-Funktion (tapi.h)
Die lineProxyMessage-Funktion wird von einem registrierten Proxyanforderungshandler verwendet, um TAPI-Nachrichten im Zusammenhang mit seiner Rolle zu generieren. Beispielsweise kann ein ACD-Agent-Handler diese Funktion verwenden, um LINE_AGENTSTATUS Nachrichten zu generieren, die von allen Anwendungen empfangen werden, die die angegebene Zeile geöffnet haben. TAPI unterdrückt die Generierung der Nachricht in der in den Funktionsparametern angegebenen hLine .
Syntax
LONG lineProxyMessage(
HLINE hLine,
HCALL hCall,
DWORD dwMsg,
DWORD dwParam1,
DWORD dwParam2,
DWORD dwParam3
);
Parameter
hLine
Handle für das Open Line-Gerät. Dies wird von TAPI in die richtige hLine für jede Anwendung konvertiert, die die Nachricht empfängt.
hCall
Wenn sich die Nachricht auf einen bestimmten Aufruf bezieht (was im Fall von LINE_AGENTSTATUS nicht der Fall ist), gibt das Handle des Proxyhandlers für diesen Aufruf an. für Nachrichten, die sich nicht auf einen bestimmten Aufruf beziehen, auf NULL festgelegt werden. Dies wird von TAPI in die richtige hCall-Instanz für jede Anwendung konvertiert, die die Nachricht empfängt.
dwMsg
Die zu generierende TAPI-Nachricht. Dies muss eine Meldung sein, die von Proxyhandlern generiert werden darf.
dwParam1
Parameter, der der zu sendenden Nachricht zugeordnet ist.
dwParam2
Parameter, der der zu sendenden Nachricht zugeordnet ist.
dwParam3
Parameter, der der zu sendenden Nachricht zugeordnet ist.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder einen der folgenden negativen Fehlerwerte:
LINEERR_INVALLINEHANDLE, LINEERR_INVALCALLHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |