ITAutomatedPhoneControl::get_PhoneHandlingEnabled-Methode (tapi3if.h)

Artikel
08/26/2023

Die get_PhoneHandlingEnabled-Methode ruft den aktuellen Wert der PhoneHandlingEnabled-Eigenschaft ab. 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 Ringe eines Telefons sowie die automatisierte Anrufverarbeitung basierend auf dem Hookswitch-Zustand eines Telefons.

Syntax

HRESULT get_PhoneHandlingEnabled(
  [out] VARIANT_BOOL *pfEnabled
);

Parameter

[out] pfEnabled

VARIANT_TRUE, wenn die automatisierte Telefonverarbeitung aktiviert ist, VARIANT_FALSE, wenn die automatisierte Telefonverarbeitung nicht aktiviert ist. 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 automatischen Telefoninteraktionsfeatures 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.

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