ITAutomatedPhoneControl::p ut_PhoneHandlingEnabled-Methode (tapi3if.h)

Artikel
08/26/2023

Die put_PhoneHandlingEnabled-Methode legt die PhoneHandlingEnabled-Eigenschaft fest. Durch festlegen der -Eigenschaft werden alle Automatischen Telefoninteraktionsfeatures für dieses Telefon aktiviert oder deaktiviert. Zu den Features gehören die automatisierte Steuerung der Töne und Klingeltöne eines Telefons sowie die automatisierte Anrufverarbeitung basierend auf dem Hookswitch-Zustand eines Telefons.

Syntax

HRESULT put_PhoneHandlingEnabled(
  [in] VARIANT_BOOL fEnabled
);

Parameter

[in] fEnabled

Wenn VARIANT_TRUE, ist die Telefonbehandlung aktiviert. Wenn VARIANT_FALSE, ist die Telefonbehandlung deaktiviert. Der Standardwert ist VARIANT_FALSE.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlerwert zurückgegeben.

Hinweise

In der Regel legt eine Anwendung andere Eigenschaften auf der ITAutomatedPhoneControl-Schnittstelle fest (um die Details der erforderlichen Features für die automatische Telefoninteraktion zu konfigurieren), bevor die PhoneHandlingEnabled-Eigenschaft auf VARIANT_TRUE festgelegt wird. Sie können die Eigenschaften jedoch auch anpassen, nachdem Sie die put_PhoneHandlingEnabled-Methode aufgerufen haben, um die Features zu aktivieren.

Wenn das Telefon mit einem Aufruf der ITPhone::Close-Methode geschlossen wird, wird die PhoneHandlingEnabled-Eigenschaft automatisch auf VARIANT_FALSE zurückgesetzt.

Wenn Sie die PhoneHandlingEnabled-Eigenschaft auf VARIANT_TRUE festlegen und das Telefon über kein Klingelgerät verfügt, wird der Klingelton auf dem Standardaudiogerät des Systems wiedergegeben. z. B. auf Sound Karte Lautsprechern. Weitere Informationen finden Sie unter PHONECAPS_LONG.

Eine Liste der Eigenschaftenmethoden, die die Automatischen Telefoninteraktionsfeatures abrufen und festlegen, finden Sie unter ITAutomatedPhoneControl.