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

Artikel
03/02/2024

Die put_AutoStopRingOnOffHook-Methode legt die AutoStopRingOnOffHook-Eigenschaft fest. Wenn dieses Feature aktiviert ist, führt das Aushooken des Telefons dazu, dass alle eingehenden Anrufe beendet werden, die auf dem Telefon erzeugt werden (über einen Anruf an ITAutomatedPhoneControl::StopRinger).

Syntax

HRESULT put_AutoStopRingOnOffHook(
  [in] VARIANT_BOOL fEnabled
);

Parameter

[in] fEnabled

Wenn VARIANT_TRUE, wird die automatische Anrufbeendigung aktiviert, wenn das Telefon ausgeschaltet wird. Wenn VARIANT_FALSE, deaktiviert die automatische Beendigung eingehender Anrufe, wenn das Telefon ausgeschaltet wird. 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 AutoStopRingOnOffHook-Eigenschaft funktioniert nur, wenn der Wert der PhoneHandlingEnabled-Eigenschaft VARIANT_TRUE ist. Sie können die AutoStopRingOnOffHook-Eigenschaft jederzeit festlegen. Die Neukonfiguration wird beim nächsten Ausschalten des Telefons wirksam.