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

Weitere Informationen

LINE_AGENTSTATUS

Ergänzende Zeilendienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz