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

Artikel
03/02/2024

Die put_AutoDialtone-Methode legt den Wert der AutoDialtone-Eigenschaft fest. Die -Methode aktiviert oder deaktiviert die automatische Anruftonantwort für dieses Telefon. Wenn dieses Feature aktiviert ist, führt das Aushooken des Telefons zu einem Wählton, der auf dem audio-Rendergerät erzeugt wird, das dem Telefon zugeordnet ist. Es wird kein Wählton erzeugt, wenn das Telefon klingelte, wenn es aus dem Offhook ging.

Syntax

HRESULT put_AutoDialtone(
  [in] VARIANT_BOOL fEnabled
);

Parameter

[in] fEnabled

Wenn VARIANT_TRUE, wird die automatische Tonwahl aktiviert. Wenn VARIANT_FALSE, deaktiviert den automatischen Wählton. Der Standardwert ist VARIANT_TRUE.

Rückgabewert

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

Hinweise

Die AutoDialtone-Eigenschaft funktioniert nur, wenn der Wert der PhoneHandlingEnabled-Eigenschaft VARIANT_TRUE ist. Sie können die AutoDialtone-Eigenschaft jederzeit festlegen. Die Neukonfiguration wird beim nächsten Ausschalten des Telefons wirksam.

Alle Wähltöne werden eingestellt, wenn ein Aufruf von ITAutomatedPhoneControl::SelectCall erfolgreich ist; Die Generierung von Wähltönen bleibt angehalten, bis der Anruf deaktiviert ist.