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

Artigo
08/26/2023

O método get_PhoneHandlingEnabled recupera o valor atual da 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 get_PhoneHandlingEnabled(
  [out] VARIANT_BOOL *pfEnabled
);

Parâmetros

[out] pfEnabled

VARIANT_TRUE se a manipulação automatizada de telefone estiver habilitada, VARIANT_FALSE se a manipulação automatizada de telefone não estiver habilitada. O valor padrão é VARIANT_FALSE.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele 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.

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.