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 |
|