LINE _ CALLSTATE-Meldung
Die TAPI LINE _ CALLSTATE-Nachricht wird gesendet, wenn sich der Status des angegebenen Aufrufs geändert hat. In der Regel werden während der Lebensdauer eines Aufrufs mehrere solcher Nachrichten empfangen. Anwendungen werden mit dieser Nachricht über neue eingehende Aufrufe benachrichtigt. Der neue Aufruf befindet sich im Angebotszustand. Die Anwendung kann lineGetCallStatus verwenden, um ausführlichere Informationen zum aktuellen Status des Aufrufs abzurufen.
Parameter
-
hDevice
-
Ein Handle für den Aufruf.
-
dwCallbackInstance
-
Die Rückrufinstanz, die beim Öffnen der Zeile des Aufrufs angegeben wird.
-
dwParam1
-
Der neue Aufrufzustand. Dieser Parameter darf nur eine der folgenden LINECALLSTATE-Konstanten _ sein.
dwParam1 Bedeutung - LINECALLSTATE _ AUSGELASTET
dwParam2 enthält Details zum Ausgelasteten Modus. Dieser Parameter verwendet eine der LINEBUSYMODE-Konstanten. _ - LINECALLSTATE _ CONNECTED
dwParam2 enthält Details zum verbundenen Modus. Dieser Parameter verwendet eine der LINECONNECTEDMODE-Konstanten. _ - LINECALLSTATE _ DIALTONE
dwParam2 enthält Details zum Wähltonmodus. Dieser Parameter verwendet eine der LINEDIALTONEMODE-Konstanten. _ - _LINECALLSTATE-ANGEBOT
dwParam2 enthält Details zum verbundenen Modus. Dieser Parameter verwendet eine der LINEOFFERINGMODE-Konstanten. _ - LINECALLSTATE _ SPECIALINFO
dwParam2 enthält die Details zum Sonderinformationsmodus. Dieser Parameter verwendet eine der LINESPECIALINFO-Konstanten. _ - LINECALLSTATE _ DISCONNECTED
dwParam2 enthält Details zum Trennungsmodus. Dieser Parameter verwendet eine der LINEDISCONNECTMODE-Konstanten. _ -
dwParam2
-
Aufrufzustandsabhängige Informationen. Siehe dwParam1.
Hinweis
Verwenden Sie in Situationen, in denen eine verzögerte Antwort geeignet ist, LINEDISCONNECTMODE _ TEMPFAILURE. Wenn eine antwort in der Blockliste geeignet ist, verwenden Sie LINEDISCONNECT _ BLOCKED. Weitere Informationen finden Sie unter LINEDISCONNECTMODE-Konstanten. _
Wenn dwParam1 LINECALLSTATE _ CONFERENCED ist, enthält dwParam2 den hConfCall-Parameter des übergeordneten Aufrufs der Konferenz, der das Subjekt hCall angehört. Wenn der in dwParam2 angegebene Aufruf zuvor nicht von der Anwendung als übergeordneter Konferenzanruf (hConfCall) betrachtet wurde, muss die Anwendung dies als Ergebnis dieser Nachricht tun. Wenn die Anwendung über kein Handle für den übergeordneten Aufruf der Konferenz verfügt (da sie zuvor lineDeallocateCall für dieses Handle aufgerufen hat), wird dwParam2 auf NULL festgelegt.
-
dwParam3
-
Wenn 0 (null), gibt dieser Parameter an, dass die Anwendungsberechtigung für den Aufruf nicht geändert wurde.
Wenn der Wert ungleich 0 (null) ist, wird die Anwendungsberechtigung für den Aufruf angegeben. Dies geschieht in den folgenden Situationen: (1) Das erste Mal, wenn die Anwendung ein Handle für diesen Aufruf erhält; (2) Wenn die Anwendung das Ziel einer Anrufabreichung ist (auch wenn die Anwendung bereits Besitzer des Aufrufs war). Dieser Parameter verwendet eine der folgenden LINECALLPRIVILEGE-Konstanten. _
Rückgabewert
Kein Rückgabewert.
Hinweise
Diese Meldung wird an jede Anwendung gesendet, die über ein Handle für den Aufruf verfügt. Die LINE _ CALLSTATE-Nachricht benachrichtigt auch Anwendungen, die Aufrufe in einer Zeile über das Vorhandensein und den Status ausgehender Anrufe überwachen, die von anderen Anwendungen oder manuell vom Benutzer (z. B. auf einem angeschlossenen Telefongerät) eingerichtet wurden. Der Aufrufzustand solcher Aufrufe spiegelt den tatsächlichen Zustand des Aufrufs wider, der nicht anbietet. Durch Untersuchen des Anrufzustands kann die Anwendung bestimmen, ob es sich bei dem Aufruf um einen eingehenden Anruf handelt, der beantwortet werden muss.
Eine LINE _ CALLSTATE-Nachricht mit einem unbekannten Aufrufstatus kann als Ergebnis einer erfolgreichen LineMakeCall-, lineForward-, lineUnpark-, lineSetupTransfer-, linePickup-, lineSetupConference-oder linePrepareAddToConference-Anforderung, die von einer anderen Anwendung angefordert wurde, an eine Überwachungsanwendung gesendet werden. Während die anfordernde Anwendung eine LINE _ REPLY-Nachricht (Erfolg) für den angeforderten Vorgang erhält, wird allen Überwachungsanwendungen in der Zeile die Meldung LINE _ CALLSTATE (unbekannt) gesendet. Eine LINE _ CALLSTATE-Nachricht, die den "echten" Aufrufzustand des neu generierten Aufrufs angibt, wird kurz danach (unter Verwendung der vom Dienstanbieter bereitgestellten Informationen) an die anfordernden und überwachenden Anwendungen gesendet.
Eine LINE _ CALLSTATE -Nachricht (unbekannt) wird nur dann an Überwachungsanwendungen gesendet, wenn lineCompleteTransfer dazu führt, dass Aufrufe in einer dreistufigen Konferenz aufgelöst werden.
Aus Gründen der Abwärtskompatibilität erwarten ältere Anwendungen keinen bestimmten Wert in dwParam2 einer LINECALLSTATE _ CONFERENCED-Nachricht. TAPI übergibt daher den übergeordneten Aufruf hConfCall in dwParam2, unabhängig von der API-Version der Anwendung, die die Nachricht empfängt. Im Fall eines vom Dienstanbieter initiierten Telefonats ist der älteren Anwendung nicht bekannt, dass der übergeordnete Anruf zu einem Telefonkonferenzaufruf geworden ist, es sei denn, es geschieht, andere Informationen zu untersuchen (z. B. call lineGetConfRelatedCalls).
Diese Meldung kann nicht deaktiviert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|