LINE_APPNEWCALL Nachricht
Die TAPI LINE_APPNEWCALL Nachricht wird gesendet, um eine Anwendung darüber zu informieren, wenn ein neues Aufrufhandle in ihrem Namen spontan erstellt wurde (anders als über einen API-Aufruf aus der Anwendung, in diesem Fall wäre das Handle über einen zeigerparameter zurückgegeben worden, der an die Funktion übergeben wurde).
Parameter
-
hGeräte
-
Das Handle der Anwendung für das Leitungsgerät, auf dem der Aufruf erstellt wurde.
-
dwCallbackInstance
-
Der Rückruf instance beim Öffnen der Anrufzeile angegeben.
-
dwParam1
-
Bezeichner der Adresse in der Zeile, in der der Aufruf angezeigt wird. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt über Betriebssystemupgrades hinweg 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.
Bemerkungen
Anwendungen, die TAPI Version 2.0 oder höher unterstützen, erhalten eine LINE_APPNEWCALL Nachricht, wenn der Anwendung spontan ein Handle für einen neuen Aufruf zugewiesen 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. Der LINE_APPNEWCALL Nachricht folgt immer sofort eine LINE_CALLSTATE Nachricht, die den Anfangszustand des Aufrufs angibt.
Ältere Anwendungen (die eine API-Version früher als 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 nichtzero-Wert festgelegt ist und ein Aufrufhandle enthält, das der Anwendung derzeit nicht bekannt ist. Die Nachteile sind, dass (a) die Anwendung lineGetCallInfo aufrufen muss, um die dem Aufruf zugeordneten Parameter hLine und dwAddressID zu bestimmen. (b) Die Anwendung muss alle bekannten Aufrufhandles überprüfen, um festzustellen, dass es sich bei dem Anruf um einen neuen Aufruf handelt; und (c) Unter bestimmten Bedingungen kann die Anwendung davon ausgehen, dass sie einen neuen Anrufhandle empfängt, wenn sie ihren Handle in Wirklichkeit gerade dem Anruf zugeordnet hat (beispielsweise hat die Anwendung gerade ein Anrufhandle zugeordnet, aber eine LINE_CALLSTATE Nachricht, die der Anwendung den Besitz des Anrufs aufgrund einer ZeileHandoff von einer anderen Anwendung gibt, befand sich bereits in der TAPI-Nachrichtenwarteschlange der Anwendung).
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|