TSPI_phoneClose, fonction (tspi.h)
La fonction TSPI_phoneClose ferme l’appareil téléphonique ouvert spécifié après avoir terminé ou abandonné toutes les opérations asynchrones en suspens sur l’appareil.
Syntaxe
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
Paramètres
hdPhone
Le handle opaque du fournisseur de services au téléphone à fermer. Une fois le téléphone fermé, ce handle n’est plus valide.
Valeur retournée
Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Remarques
Le fournisseur de services doit signaler l’achèvement de chaque opération asynchrone. Si cette procédure est appelée pour un téléphone sur lequel des opérations asynchrones sont en attente, les opérations doivent être signalées terminées avec un résultat ou un code d’erreur approprié avant que cette procédure ne retourne. En règle générale, TAPI attend que celles-ci se terminent de manière ordonnée. Toutefois, le fournisseur de services doit être prêt à gérer un appel précoce à TSPI_phoneClose dans les situations d’abandon ou d’arrêt d’urgence.
Une fois cette procédure retournée, le fournisseur de services ne doit signaler aucun autre événement sur le téléphone. Le handle opaque du fournisseur de services pour le téléphone devient non valide.
Le fournisseur de services doit renoncer aux ressources non partageables qu’il réserve pendant que le téléphone est ouvert. Par exemple, la fermeture d’un téléphone accessible via un port de communication et un modem doit entraîner la fermeture du port de communication, ce qui le rend accessible à d’autres applications.
Cette fonction doit toujours réussir, sauf dans des circonstances extraordinaires. La plupart des appelants ignoreront probablement le code de retour, car ils ne pourront pas compenser les erreurs qui se produisent. Les valeurs de retour spécifiées sont plus avisées à des fins de diagnostic de développement que toute autre chose.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |