ITAutomatedPhoneControl::get_AutoDialtone-Methode (tapi3if.h)

Artikel
08/26/2023

Die get_AutoDialtone-Methode ruft den aktuellen Wert der AutoDialtone-Eigenschaft ab. Wenn dieses Feature aktiviert ist, führt das Ausschalten des Telefons zu einem Wählton, der auf dem audiorendernden Gerät erzeugt wird, das dem Telefon zugeordnet ist. Es wird kein Wählton erzeugt, wenn das Telefon klingelte, als es ausgeschaltet wurde.

Syntax

HRESULT get_AutoDialtone(
  [out] VARIANT_BOOL *pfEnabled
);

Parameter

[out] pfEnabled

Wenn VARIANT_TRUE, ist der automatische Tonfall aktiviert. Wenn VARIANT_FALSE, ist der automatische Tonfall deaktiviert.

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 wirksam, wenn das Telefon das nächste Mal ausgeschaltet wird.

Alle Generierung von Ziffertonen endet, wenn ein Aufruf von ITAutomatedPhoneControl::SelectCall erfolgreich ist; Die Generierung von Wähltons bleibt angehalten, bis der Anruf nicht ausgewählt wird.