Método ITAutomatedPhoneControl::get_AutoDialtone (tapi3if.h)

Artigo
08/26/2023

O método get_AutoDialtone recupera o valor atual da propriedade AutoDialtone . Quando esse recurso está habilitado, o telefone desligado resulta em um tom de discagem produzido no dispositivo de renderização de áudio associado ao telefone. Nenhum tom de discagem é produzido se o telefone estava tocando quando ficou desligado.

Sintaxe

HRESULT get_AutoDialtone(
  [out] VARIANT_BOOL *pfEnabled
);

Parâmetros

[out] pfEnabled

Se VARIANT_TRUE, o tom de discagem automática estará habilitado. Se VARIANT_FALSE, o tom de discagem automática será desabilitado.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um valor de erro.

Comentários

A propriedade AutoDialtone funciona somente quando o valor da propriedade PhoneHandlingEnabled é VARIANT_TRUE. Você pode definir a propriedade AutoDialtone a qualquer momento. A reconfiguração entrará em vigor na próxima vez que o telefone ficar desligado.

Toda a geração de tom de discagem termina quando uma invocação de ITAutomatedPhoneControl::SelectCall é bem-sucedida; A geração de tom de discagem permanece suspensa até que a chamada seja desmarcada.