Freigeben über


LINE_CALLSTATE Nachricht

Die TAPI-LINE_CALLSTATE Nachricht wird gesendet, wenn sich die status des angegebenen Aufrufs geändert hat. In der Regel werden mehrere solcher Nachrichten während der Lebensdauer eines Anrufs empfangen. Anwendungen werden über neue eingehende Anrufe mit dieser Nachricht 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

Der Rückruf instance beim Öffnen der Anrufzeile angegeben.

dwParam1

Der neue Aufrufstatus. Dieser Parameter muss nur eine der folgenden LINECALLSTATE_ Konstanten sein.

dwParam1 Bedeutung
LINECALLSTATE_BUSY
dwParam2 enthält Details zum Ausgelastungsmodus. 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ählmodus. Dieser Parameter verwendet eine der LINEDIALTONEMODE_ Konstanten.
LINECALLSTATE_OFFERING
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

Vom Aufrufzustand abhängige Informationen. Weitere Informationen finden Sie unter dwParam1.

Hinweis

Verwenden Sie in Fällen, in denen eine verzögerte Antwort angemessen ist, LINEDISCONNECTMODE_TEMPFAILURE. Wenn eine Antwort auf die 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, deren Betreff hCall Mitglied ist. Wenn der in dwParam2 angegebene Anruf zuvor von der Anwendung nicht als übergeordnete Telefonkonferenz (hConfCall) betrachtet wurde, muss die Anwendung dies aufgrund dieser Nachricht tun. Wenn die Anwendung kein Handle für den übergeordneten Aufruf der Konferenz hat (da sie zuvor lineDeallocateCall für dieses Handle aufgerufen hat), wird dwParam2 auf NULL festgelegt.

dwParam3

Wenn null, gibt dieser Parameter an, dass die Berechtigung der Anwendung für den Aufruf nicht geändert wurde.

Wenn der Wert ungleich null ist, wird die Berechtigung der Anwendung für den Aufruf angegeben. Dies geschieht in den folgenden Situationen: (1) Das erste Mal, wenn der Anwendung ein Handle für diesen Aufruf erteilt wird; (2) Wenn die Anwendung das Ziel einer Anrufübergabe ist (auch wenn die Anwendung bereits besitzer des Anrufs war). Dieser Parameter verwendet eine der folgenden LINECALLPRIVILEGE_ Konstanten.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

Diese Nachricht wird an jede Anwendung gesendet, die über ein Handle für den Anruf verfügt. Die LINE_CALLSTATE-Nachricht benachrichtigt auch Anwendungen, die Anrufe in einer Zeile überwachen, über das Vorhandensein und den Status von ausgehenden Anrufen, 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 Anrufs wider, der nicht angeboten wird. Durch Die Untersuchung des Anrufstatus kann die Anwendung ermitteln, ob es sich bei dem Anruf um einen eingehenden Anruf handelt, der angenommen werden muss oder nicht.

Eine LINE_CALLSTATE Nachricht mit einem unbekannten Anrufstatus kann als Ergebnis einer erfolgreichen lineMakeCall-, lineForward-, lineUnpark-, lineSetupTransfer-, linePickup-, lineSetupConference- oder linePrepareAddToConference-Instanz , die von einer anderen Anwendung angefordert wurde, an eine Überwachungsanwendung gesendet werden. Gleichzeitig, wenn der anfordernden Anwendung ein LINE_REPLY (Erfolg) für den angeforderten Vorgang gesendet wird, erhalten alle Überwachungsanwendungen auf der Zeile die LINE_CALLSTATE (unbekannt) Nachricht. Eine LINE_CALLSTATE Meldung, die den "echten" Anrufstatus des neu generierten Anrufs angibt, wird kurz darauf (unter Verwendung der vom Dienstanbieter bereitgestellten Informationen) an die anfordernden und überwachenden Anwendungen gesendet.

Eine LINE_CALLSTATE (unbekannte) Nachricht wird nur dann an Überwachungsanwendungen gesendet, wenn lineCompleteTransfer bewirkt, dass Anrufe in eine Drei-Wege-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 einer vom Dienstanbieter initiierten Telefonkonferenz ist der älteren Anwendung nicht bewusst, dass der übergeordnete Anruf zu einer Telefonkonferenz geworden ist, es sei denn, sie untersucht spontan andere Informationen (z. B. AnrufzeileGetConfRelatedCalls).

Diese Meldung kann nicht deaktiviert werden.

Anforderungen

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

Siehe auch

LINE_REPLY

lineCompleteTransfer

lineDeallocateCall

LINEDIALPARAMS

lineForward

lineGenerateDigits

lineGetCallStatus

lineGetConfRelatedCalls

lineMakeCall

linePickup

linePrepareAddToConference

lineSetupTransfer

lineUnpark