ITAutomatedPhoneControl-Schnittstelle (tapi3if.h)
ItAutomatedPhoneControl ist eine vollständig durch OLE automatisierbare und skriptfähige Schnittstelle, die vom TAPI-Telefonobjekt verfügbar gemacht wird. Wenn ein Telefongerät mit Besitzerberechtigung geöffnet wird, können Sie die QueryInterface-Methode auf der ITPhone-Schnittstelle aufrufen, um einen ITAutomatedPhoneControl-Schnittstellenzeiger zu erhalten.
Diese Schnittstelle führt mehrere allgemeine Telefonfunktionen aus:
- Aktivieren und konfigurieren Sie die automatisierte Steuerung der Töne und Klingeltöne des Telefons basierend auf eingaben des Hookswitches und der Tasten des Telefons.
- Aktivieren und konfigurieren Sie die automatisierte Anrufverarbeitung basierend auf dem Hookswitch-Zustand des Telefons. Wenn das Telefon beispielsweise während der Behandlung eines verbundenen Anrufs onhook, kann das phone-Objekt automatisch ITBasicCallControl::D isconnect für diesen Anruf aufrufen.
- Generieren Sie bestimmte Töne auf den Audiogeräten, die dem Telefon zugeordnet sind, ohne direkt auf Audio-APIs zuzugreifen. Das Ton-Steuerelement ermöglicht es einer Anwendung, Töne auf den Audiogeräten, die dem Telefon zugeordnet sind, außerhalb des Kontexts eines Anrufs abzuspielen. Da diese Töne bei keinem Anruf übertragen werden, sind sie unabhängig von der Audiostreamingfunktion, auf die über Terminals zugegriffen wird.
- Rufen Sie das Telefon an, ohne informationen darüber zu benötigen, ob das Telefon über einen Klingelton verfügt, und bestimmen Sie, wenn das Telefon einen Klingelton hat, die Typen von Klingeln, die das Telefon unterstützt.
Vererbung
Die ITAutomatedPhoneControl-Schnittstelle erbt von der IDispatch-Schnittstelle . ITAutomatedPhoneControl verfügt auch über folgende Arten von Membern:
Methoden
Die ITAutomatedPhoneControl-Schnittstelle verfügt über diese Methoden.
| ITAutomatedPhoneControl::EnumerateSelectedCalls Die EnumerateSelectedCalls-Methode ruft ein Enumeratorobjekt ab, das angibt, welche Aufrufe derzeit auf diesem Telefon ausgewählt sind. Weitere Informationen finden Sie unter ITAutomatedPhoneControl::SelectCall. |
| ITAutomatedPhoneControl::get_AutoDialtone Die get_AutoDialtone-Methode ruft den aktuellen Wert der AutoDialtone-Eigenschaft ab. |
| ITAutomatedPhoneControl::get_AutoEndOfNumberTimeout Die get_AutoEndOfNumberTimeout-Methode ruft den aktuellen Wert der AutoEndOfNumberTimeout-Eigenschaft ab. Die -Eigenschaft gibt an, wie lange gewartet werden soll, nachdem eine Ziffer gedrückt wurde, bevor davon ausgegangen wird, dass die gesamte Zahl erfasst wurde. |
| ITAutomatedPhoneControl::get_AutoKeypadTones Die get_AutoKeypadTones-Methode ruft die AutoKeypadTones-Eigenschaft für dieses Telefon ab. Wenn dieses Feature aktiviert ist, wird automatisch ein Ziffernton wiedergegeben, wenn eine Tastaturtaste gedrückt wird. |
| ITAutomatedPhoneControl::get_AutoKeypadTonesMinimumDuration Die get_AutoKeypadTonesMinimumDuration-Methode ruft den aktuellen Wert der AutoKeypadTonesMinimumDuration-Eigenschaft ab. Die -Eigenschaft gibt an, wie lange tastaturfarbene Töne auf PBS_DOWN wiedergegeben werden sollen. |
| ITAutomatedPhoneControl::get_AutoStopRingOnOffHook Die get_AutoStopRingOnOffHook-Methode ruft den aktuellen Wert der AutoStopRingOnOffHook-Eigenschaft ab. |
| ITAutomatedPhoneControl::get_AutoStopTonesOnOnHook Die get_AutoStopTonesOnOnHook-Methode ruft den aktuellen Wert der AutoStopTonesOnOnHook-Eigenschaft ab. |
| ITAutomatedPhoneControl::get_AutoVolumeControl Die get_AutoVolumeControl-Methode ruft den aktuellen Wert der AutoVolumeControl-Eigenschaft ab. |
| ITAutomatedPhoneControl::get_AutoVolumeControlRepeatDelay Die get_AutoVolumeControlRepeatDelay-Methode ruft den aktuellen Wert der AutoVolumeControlRepeatDelay-Eigenschaft ab. Die -Eigenschaft gibt die Verzögerung in Millisekunden (ms) an, bevor eine Lautstärkeschaltfläche bei gedrückter Taste wiederholt wird. |
| ITAutomatedPhoneControl::get_AutoVolumeControlRepeatPeriod Die get_AutoVolumeControlRepeatPeriod-Methode ruft den aktuellen Wert der AutoVolumeControlRepeatPeriod-Eigenschaft ab. Die -Eigenschaft steuert den Zeitraum der Schaltflächenwiederholung in Millisekunden (ms), wenn eine Lautstärketaste gedrückt gehalten wird. |
| ITAutomatedPhoneControl::get_AutoVolumeControlStep Die get_AutoVolumeControlStep-Methode ruft den aktuellen Wert der AutoVolumeControlStep-Eigenschaft ab. Die -Eigenschaft bestimmt den Betrag, in dem die Lautstärke des Telefons angepasst wird, wenn die Lautstärketaste gedrückt wird. |
| ITAutomatedPhoneControl::get_PhoneHandlingEnabled Die get_PhoneHandlingEnabled-Methode ruft den aktuellen Wert der PhoneHandlingEnabled-Eigenschaft ab. |
| ITAutomatedPhoneControl::get_Ringer Die get_Ringer-Methode gibt einen booleschen Wert zurück, der angibt, ob das Telefon derzeit einen eingehenden Ring ausführt, der von der StartRinger-Methode auf dieser Schnittstelle initiiert wurde. |
| ITAutomatedPhoneControl::get_SelectedCalls Die get_SelectedCalls-Methode ruft einen VARIANT-Wert ab, der einen Zeiger auf ein Auflistungsobjekt enthält, der angibt, welche Aufrufe derzeit auf diesem Telefon ausgewählt sind. Weitere Informationen finden Sie unter ITAutomatedPhoneControl::SelectCall. |
| ITAutomatedPhoneControl::get_Tone Die get_Tone-Methode gibt einen PHONE_TONE Enumerationswert zurück, der den Tontyp angibt, der auf dem Telefon gerade wiedergegeben wird. |
| ITAutomatedPhoneControl::p ut_AutoDialtone Die put_AutoDialtone-Methode legt den Wert der AutoDialtone-Eigenschaft fest. |
| ITAutomatedPhoneControl::p ut_AutoEndOfNumberTimeout Die put_AutoEndOfNumberTimeout-Methode legt den Wert der AutoEndOfNumberTimeout-Eigenschaft fest. Die -Eigenschaft gibt an, wie lange gewartet werden soll, nachdem eine Ziffer gedrückt wurde, bevor davon ausgegangen wird, dass die gesamte Zahl erfasst wurde. |
| ITAutomatedPhoneControl::p ut_AutoKeypadTones Die put_AutoKeypadTones-Methode legt die AutoKeypadTones-Eigenschaft für dieses Telefon fest. Wenn dieses Feature aktiviert ist, wird automatisch ein Ziffernton wiedergegeben, wenn eine Tastaturtaste gedrückt wird. |
| ITAutomatedPhoneControl::p ut_AutoKeypadTonesMinimumDuration Die put_AutoKeypadTonesMinimumDuration-Methode legt den Wert der AutoKeypadTonesMinimumDuration-Eigenschaft fest. Die -Eigenschaft gibt an, wie lange tastaturfarbene Töne auf PBS_DOWN wiedergegeben werden sollen. |
| ITAutomatedPhoneControl::p ut_AutoStopRingOnOffHook Die put_AutoStopRingOnOffHook-Methode legt die AutoStopRingOnOffHook-Eigenschaft fest. Wenn dieses Feature aktiviert ist, führt das Aushooken des Telefons dazu, dass alle eingehenden Anrufe beendet werden, die auf dem Telefon erzeugt werden (über einen Anruf an ITAutomatedPhoneControl::StopRinger). |
| ITAutomatedPhoneControl::p ut_AutoStopTonesOnOnOnHook Die put_AutoStopTonesOnOnHook-Methode legt die AutoStopTonesOnOnOnHook-Eigenschaft für dieses Telefon fest. |
| ITAutomatedPhoneControl::p ut_AutoVolumeControl Die put_AutoVolumeControl-Methode legt die AutoVolumeControl-Eigenschaft für dieses Telefon fest. |
| ITAutomatedPhoneControl::p ut_AutoVolumeControlRepeatDelay Die put_AutoVolumeControlRepeatDelay-Methode legt die AutoVolumeControlRepeatDelay-Eigenschaft fest. Die -Eigenschaft gibt die Verzögerung in Millisekunden (ms) an, bevor eine Lautstärkeschaltfläche bei gedrückter Taste wiederholt wird. |
| ITAutomatedPhoneControl::p ut_AutoVolumeControlRepeatPeriod Die put_AutoVolumeControlRepeatPeriod-Methode legt die AutoVolumeControlRepeatPeriod-Eigenschaft fest. Die -Eigenschaft steuert den Zeitraum der Schaltflächenwiederholung in Millisekunden (ms), wenn eine Lautstärketaste gedrückt gehalten wird. |
| ITAutomatedPhoneControl::p ut_AutoVolumeControlStep Die put_AutoVolumeControlStep-Methode legt die AutoVolumeControlStep-Eigenschaft fest. Die -Eigenschaft bestimmt den Betrag, in dem die Lautstärke des Telefons angepasst wird, wenn die Lautstärketaste gedrückt wird. |
| ITAutomatedPhoneControl::p ut_PhoneHandlingEnabled Die put_PhoneHandlingEnabled-Methode legt die PhoneHandlingEnabled-Eigenschaft fest. |
| ITAutomatedPhoneControl::SelectCall Die SelectCall-Methode wählt das aktuelle Telefonobjekt im Call-Objekt aus, auf das der pCall-Parameter verweist. |
| ITAutomatedPhoneControl::StartRinger Die StartRinger-Methode startet das Klingeln des Telefons und gibt dabei den Ringmodus und die Dauer des Klingelns an. |
| ITAutomatedPhoneControl::StartTone Die StartTone-Methode sendet Steuertöne. |
| ITAutomatedPhoneControl::StopRinger Die StopRinger-Methode beendet jeden eingehenden Ring, der gerade erstellt wird. Wenn kein Ring erstellt wird, führt die Methode keine Aktion aus und gibt den Erfolg zurück. |
| ITAutomatedPhoneControl::StopTone Die StopTone-Methode beendet jeden Ton, der gerade wiedergegeben wird. Wenn kein Ton wiedergegeben wird, führt die Methode keine Aktion aus und gibt den Erfolg zurück. |
| ITAutomatedPhoneControl::UnselectCall Die UnselectCall-Methode entfernt den angegebenen Anruf aus diesem Telefonobjekt und gibt den Verweis des phone-Objekts auf das Anrufobjekt frei. |
Hinweise
Ein ITAutomatedPhoneControl-Zeiger wird ungültig, wenn die ITPhone::Close-Methode aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für