ITAutomatedPhoneControl::put_AutoDialtone method (tapi3if.h)

The put_AutoDialtone method sets the value of the AutoDialtone property. The method enables or disables automatic dial tone response for this phone. When this feature is enabled, the phone going offhook results in a dial tone produced on the audio render device associated with the phone. No dial tone is produced if the phone was ringing when it went offhook.

Syntax

HRESULT put_AutoDialtone(
  [in] VARIANT_BOOL fEnabled
);

Parameters

[in] fEnabled

If VARIANT_TRUE, enables automatic dial tone. If VARIANT_FALSE, disables automatic dial tone. The default value is VARIANT_TRUE.

Return value

If the method succeeds, it returns S_OK. Otherwise, it returns an error value.

Remarks

The AutoDialtone property functions only when the value of the PhoneHandlingEnabled property is VARIANT_TRUE. You can set the AutoDialtone property at any time. The reconfiguration takes effect the next time the phone goes offhook.

All dial tone generation ceases when an invocation of ITAutomatedPhoneControl::SelectCall succeeds; dial tone generation remains suspended until the call is unselected.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

ITAutomatedPhoneControl

ITAutomatedPhoneControl::SelectCall

get_AutoDialtone

put_PhoneHandlingEnabled