ITAutomatedPhoneControl::p ut_PhoneHandlingEnabled, méthode (tapi3if.h)

La méthode put_PhoneHandlingEnabled définit la propriété PhoneHandlingEnabled . La définition de la propriété active ou désactive toutes les fonctionnalités d’interaction automatique par téléphone pour ce téléphone. Les fonctionnalités incluent le contrôle automatisé des sons et des sonneries d’un téléphone, ainsi que la gestion automatisée des appels en fonction de l’état d’interconnexion d’un téléphone.

Syntaxe

HRESULT put_PhoneHandlingEnabled(
  [in] VARIANT_BOOL fEnabled
);

Paramètres

[in] fEnabled

Si VARIANT_TRUE, la gestion des téléphones est activée. Si VARIANT_FALSE, la gestion par téléphone est désactivée. La valeur par défaut est VARIANT_FALSE.

Valeur retournée

Si la méthode réussit, retourne S_OK. Sinon, elle retourne une valeur d’erreur.

Remarques

En règle générale, une application définit d’autres propriétés sur l’interface ITAutomatedPhoneControl (pour configurer les détails des fonctionnalités d’interaction automatique par téléphone requises) avant de définir la propriété PhoneHandlingEnabled sur VARIANT_TRUE. Toutefois, vous pouvez également ajuster les propriétés après avoir appelé la méthode put_PhoneHandlingEnabled pour activer les fonctionnalités.

Lorsque le téléphone est fermé avec un appel à la méthode ITPhone::Close , la propriété PhoneHandlingEnabled est automatiquement réinitialisée à VARIANT_FALSE.

Si vous définissez la propriété PhoneHandlingEnabled sur VARIANT_TRUE et que le téléphone n’a pas d’appareil de sonnerie, le son de sonnerie est lu sur le périphérique audio par défaut du système ; par exemple, sur le son carte haut-parleurs. Pour plus d’informations, consultez PHONECAPS_LONG.

Pour obtenir la liste des méthodes de propriété qui obtiennent et définissent les fonctionnalités d’interaction automatique par téléphone, consultez ITAutomatedPhoneControl.

Configuration requise

Plateforme cible	Windows
En-tête	tapi3if.h (inclure Tapi3.h)
Bibliothèque	Uuid.lib
DLL	Tapi3.dll

Voir aussi

ITAutomatedPhoneControl

ITPhone::Close

get_PhoneHandlingEnabled