ITAutomatedPhoneControl::get_AutoStopTonesOnOnHook-Methode (tapi3if.h)

Die get_AutoStopTonesOnOnHook-Methode ruft den aktuellen Wert der AutoStopTonesOnOnOnHook-Eigenschaft ab. Wenn dieses Feature aktiviert ist, führt das Telefon beim Onhook dazu, dass jeder Ton beendet wird, der auf dem Audiorenderinggerät erzeugt wird, das dem Telefon zugeordnet ist (über einen Anruf an ITAutomatedPhoneControl::StopTone).

Syntax

HRESULT get_AutoStopTonesOnOnHook(
  [out] VARIANT_BOOL *pfEnabled
);

Parameter

[out] pfEnabled

Wenn VARIANT_TRUE, wird das automatische Beenden der Tongenerierung beim Onhook aktiviert. Wenn VARIANT_FALSE, ist das automatische Beenden der Tongenerierung beim Onhook deaktiviert.

Rückgabewert

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

Hinweise

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

Anforderungen

Weitere Informationen

ITAutomatedPhoneControl

ITAutomatedPhoneControl::StopTone

put_AutoStopTonesOnOnHook

put_PhoneHandlingEnabled