LINECONNECTEDMODE_ Konstanten
Die LINECONNECTEDMODE_ Bitflagkonstanten beschreiben verschiedene Unterzustände eines verbundenen Aufrufs. Ein Modus ist als Aufruf status für die Anwendung verfügbar, nachdem der Anrufstatus zu verbunden übertritt, und innerhalb der LINE_CALLSTATE Nachricht, die angibt, dass sich der Aufruf in LINECALLSTATE_CONNECTED befindet. Diese Werte werden verwendet, wenn der Aufruf für eine Adresse erfolgt, die mit anderen Stationen geteilt (überbrückt) wird (weitere Informationen finden Sie unter LINEADDRESSSHARING_ Konstanten), hauptsächlich elektronische Schlüsselsysteme. Die LINECONNECTEDMODE_constants weisen die folgenden Werte auf:
-
LINECONNECTEDMODE_ACTIVE
-
-
Gibt an, dass der Anruf an der aktuellen Station verbunden ist (die aktuelle Station ist teilnehmer am Anruf). Wenn der Aufrufzustandsmodus 0 (null) ist, sollte die Anwendung davon ausgehen, dass der Wert "aktiv" ist (dies wäre die Situation für eine nicht überbrückte Adresse). Der Modus kann während eines Anrufs zwischen ACTIVE und INACTIVE wechseln, wenn der Benutzer den Aufruf durch manuelle Aktion verknüpft und verlässt. In einer solchen überbrückten Situation kann ein lineDrop- oder lineHold-Vorgang den Anruf möglicherweise nicht tatsächlich abbrechen oder in die Warteschleife legen, da die status anderer Stationen des Anrufs steuern kann (z. B. der Versuch, einen Anruf zu "halten", wenn andere Stationen teilnehmen, ist nicht möglich). Stattdessen kann der Anruf in den INACTIVE-Modus geändert werden, wenn er an anderen Stationen VERBUNDEN bleibt.
-
-
LINECONNECTEDMODE_ACTIVEHELD
-
-
Gibt an, dass die Station ein aktiver Teilnehmer am Anruf ist, aber dass die Remotepartei den Anruf in die Warteschleife gesetzt hat (die andere Partei hält den Anruf für im Rückhaltezustand). Normalerweise sind solche Informationen nur verfügbar, wenn beide Endpunkte des Anrufs innerhalb derselben Wechseldomäne liegen. Dieses Flag wird nur für Anwendungen verfügbar gemacht, die eine TAPI-Version von 2.0 oder höher aushandeln. (TAPI-Versionen 2.0 und höher)
-
-
LINECONNECTEDMODE_CONFIRMED
-
-
Gibt an, dass der Dienstanbieter eine positive Benachrichtigung erhalten hat, dass der Aufruf in den verbundenen Zustand eingetreten ist (z. B. durch Eine Antwortüberwachung oder ähnliche Mechanismen). Dieses Flag wird nur für Anwendungen verfügbar gemacht, die eine TAPI-Version von 2.0 oder höher aushandeln. (TAPI-Versionen 2.0 und höher)
-
-
LINECONNECTEDMODE_INACTIVE
-
-
Gibt an, dass der Anruf an einer oder mehreren anderen Stationen aktiv ist, die aktuelle Station jedoch kein Teilnehmer am Anruf ist. Wenn der Aufrufzustandsmodus NULL ist, sollte die Anwendung davon ausgehen, dass der Wert "aktiv" ist (dies wäre die Situation für eine nicht überbrückte Adresse). Ein Aufruf im ZUSTAND INACTIVE kann mithilfe von lineAnswer verknüpft werden. Viele Vorgänge, die bei Anrufen im ZUSTAND VERBUNDEN gültig sind, können im INACTIVE-Modus nicht möglich sein, z. B. die Überwachung von Tönen und Ziffern, da die Station tatsächlich nicht am Anruf teilnimmt; Die Überwachung wird normalerweise angehalten (wenn auch nicht abgebrochen), während sich der Aufruf im INACTIVE-Modus befindet.
-
-
LINECONNECTEDMODE_INACTIVEHELD
-
-
Gibt an, dass die Station kein aktiver Teilnehmer am Anruf ist und dass die Remotepartei den Anruf in die Warteschleife gesetzt hat. Dieses Flag wird nur für Anwendungen verfügbar gemacht, die eine TAPI-Version von 2.0 oder höher aushandeln. (TAPI-Versionen 2.0 und höher)
-
Bemerkungen
Nicht erweiterbar. Alle 32 Bits sind reserviert.
Aus Gründen der Abwärtskompatibilität ist der Dienstanbieter dafür verantwortlich, die ausgehandelte API-Version in der Zeile zu überprüfen und nicht die LINECONNECTEDMODE_ Werte zu verwenden, die in der ausgehandelten Version nicht unterstützt werden. Anwendungen, die LINECONNECTEDMODE_ nicht kennen, gehen höchstwahrscheinlich davon aus, dass sich ein Aufruf in LINECALLSTATE_CONNECTED in LINECONNECTEDMODE_ACTIVE befindet.
Die werte LINECONNECTEDMODE_ACTIVE und LINECONNECTEDMODE_INACTIVE werden verwendet, wenn der Aufruf für eine Adresse erfolgt, die mit anderen Stationen geteilt wird (überbrückt; siehe LINEADDRESSSHARING_ Konstanten), in erster Linie elektronische Schlüsselsysteme. Wenn der Zustandsmodus des verbundenen Anrufs "aktiv" ist, bedeutet dies, dass der Anruf an der aktuellen Station verbunden ist (die aktuelle Station ist teilnehmer am Anruf). Wenn der Anrufstatusmodus "inaktiv" ist, ist der Anruf an einer oder mehreren anderen Stationen aktiv, aber die aktuelle Station ist kein Teilnehmer am Anruf. Wenn der Aufrufzustandsmodus NULL ist, sollte die Anwendung davon ausgehen, dass der Wert "aktiv" ist (dies wäre die Situation für eine nicht überbrückte Adresse). Der Modus kann während eines Anrufs zwischen ACTIVE und INACTIVE wechseln, wenn der Benutzer den Aufruf durch manuelle Aktion verknüpft und verlässt.
In einer solchen überbrückten Situation kann ein lineDrop- oder lineHold-Vorgang den Anruf möglicherweise nicht tatsächlich abwerfen oder in die Warteschleife legen, da die status anderer Stationen im Anruf steuern kann (z. B. der Versuch, einen Anruf zu "halten", wenn andere Stationen teilnehmen, ist nicht möglich); stattdessen kann der Anruf einfach in den INACTIVE-Modus geändert werden, wenn er an anderen Stationen verbunden bleibt. Ein Aufruf im ZUSTAND INACTIVE kann mithilfe von lineAnswer verknüpft werden.
Viele Vorgänge, die bei Anrufen im verbundenen Zustand gültig sind, können im INACTIVE-Modus nicht möglich sein, z. B. die Überwachung von Tönen und Ziffern, da die Station tatsächlich nicht am Anruf teilnimmt; Die Überwachung wird normalerweise angehalten (wenn auch nicht abgebrochen), während sich der Aufruf im INACTIVE-Modus befindet.
Anforderungen
Anforderung | Wert |
---|---|
TAPI-Version |
Erfordert TAPI 2.0 oder höher |
Header |
|