Método ITAutomatedPhoneControl::p ut_PhoneHandlingEnabled (tapi3if.h)

Artigo
08/26/2023

O método put_PhoneHandlingEnabled define a propriedade PhoneHandlingEnabled . Definir a propriedade habilita ou desabilita todos os recursos de interação automática do telefone para este telefone. Os recursos incluem o controle automatizado dos tons e anéis de um telefone e o tratamento automatizado de chamadas com base no estado hookswitch de um telefone.

Sintaxe

HRESULT put_PhoneHandlingEnabled(
  [in] VARIANT_BOOL fEnabled
);

Parâmetros

[in] fEnabled

Se VARIANT_TRUE, a manipulação de telefone estará habilitada. Se VARIANT_FALSE, a manipulação de telefone será desabilitada. O valor padrão é VARIANT_FALSE.

Valor retornado

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

Comentários

Normalmente, um aplicativo define outras propriedades na interface ITAutomatedPhoneControl (para configurar os detalhes dos recursos de interação automática do telefone necessários) antes de definir a propriedade PhoneHandlingEnabled como VARIANT_TRUE. No entanto, você também pode ajustar as propriedades depois de chamar o método put_PhoneHandlingEnabled para habilitar os recursos.

Quando o telefone é fechado com uma chamada para o método ITPhone::Close , a propriedade PhoneHandlingEnabled é redefinida automaticamente para VARIANT_FALSE.

Se você definir a propriedade PhoneHandlingEnabled como VARIANT_TRUE e o telefone não tiver um dispositivo de toque, o som de toque será reproduzido no dispositivo de áudio padrão para o sistema; por exemplo, em alto-falantes de cartão de som. Para obter mais informações, consulte PHONECAPS_LONG.

Para obter uma lista de métodos de propriedade que obtêm e definem os recursos de interação automática do telefone, consulte ITAutomatedPhoneControl.