fonction phoneClose (tapi.h)

  • Article

La fonction phoneClose ferme l’appareil téléphonique ouvert spécifié.

Syntaxe

LONG phoneClose(
  HPHONE hPhone
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert à fermer. Si la fonction réussit, le handle n’est plus valide.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Remarques

Une fois l’appareil téléphonique ouvert fermé, l’implémentation envoie un message PHONE_CLOSE à l’application. Ces messages peuvent également être envoyés non sollicités en raison de la récupération de l’appareil téléphonique d’une manière ou d’une autre. Une application doit donc être prête à gérer ces messages fermés non sollicités. Au moment de la fermeture de l’appareil téléphonique, toutes les réponses asynchrones en suspens sont supprimées.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

PHONE_CLOSE

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2