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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |