LINE _ APPNEWCALL-Nachricht

Die TAPI LINE _ APPNEWCALL-Nachricht wird gesendet, um eine Anwendung zu informieren, wenn ein neues Aufrufhandle in ihrem Namen erstellt wurde (außer durch einen API-Aufruf von der Anwendung, in diesem Fall wäre das Handle über einen Zeigerparameter zurückgegeben worden, der an die Funktion übergeben wurde).

        

Parameter

hDevice

Das Handle der Anwendung für das Zeilengerät, auf dem der Aufruf erstellt wurde.

dwCallbackInstance

Die Rückrufinstanz, die beim Öffnen der Zeile des Aufrufs angegeben wird.

dwParam1

Bezeichner der Adresse in der Zeile, in der der Aufruf angezeigt wird. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt bei Betriebssystemupgrades konstant.

dwParam2

Das Handle der Anwendung für den neuen Aufruf.

dwParam3

Die Anwendungsberechtigung für den neuen Aufruf (LINECALLPRIVILEGE _ OWNER oder LINECALLPRIVILEGE _ MONITOR).

Rückgabewert

Kein Rückgabewert.

Hinweise

Anwendungen, die TAPI Version 2.0 oder höher unterstützen, erhalten immer dann eine LINE _ APPNEWCALL-Nachricht, wenn der Anwendung ein Handle für einen neuen Aufruf übergeben wird. Da die Nachricht die Parameter hLine und dwAddressID enthält, für die der Aufruf vorhanden ist, kann die Anwendung problemlos ein neues Aufrufobjekt im richtigen Kontext erstellen. Auf die LINE _ APPNEWCALL-Nachricht folgt immer sofort eine LINE _ CALLSTATE-Nachricht, die den Anfangszustand des Aufrufs angibt.

Ältere Anwendungen (die eine API-Version vor 2.0 ausgehandelt haben) werden nur eine LINE _ CALLSTATE-Nachricht gesendet, wie in früheren Versionen der API dokumentiert. Solche Anwendungen würden ein neues Aufrufobjekt erstellen, wenn sie eine LINE _ CALLSTATE-Nachricht empfangen, bei der dwParam3 auf einen Wert ungleich 0 (null) festgelegt ist und ein Aufrufhandle enthält, das der Anwendung derzeit nicht bekannt ist. Der Nachteil ist, dass (a) die Anwendung lineGetCallInfo aufrufen muss, um die hLine- und dwAddressID-Parameter zu bestimmen, die dem Aufruf zugeordnet sind. (b) Die Anwendung muss alle bekannten Aufrufhandles überprüfen, um zu ermitteln, ob der Aufruf ein neuer Aufruf ist. und (c) es ist möglich, dass die Anwendung unter bestimmten Bedingungen davon ausgeht, dass sie ein neues Aufrufhandle empfängt, wenn sie ihr Handle tatsächlich gerade für den Aufruf freigegeben hat (z. B. hat die Anwendung gerade die Zuordnung eines Aufrufhandles freigegeben, aber eine LINE _ CALLSTATE-Nachricht, die der Anwendung den Besitz des Aufrufs übergibt, weil ein lineHandoff von einer anderen Anwendung bereits in der TAPI-Nachrichtenwarteschlange der Anwendung vorhanden war).

Anforderungen

Anforderung Wert
TAPI-Version
Erfordert TAPI 2.0 oder höher
Header
Tapi.h

Siehe auch

LINE _ CALLSTATE

lineGetCallInfo

lineHandoff