fonction lineClose (tapi.h)

Article
03/06/2024

La fonction lineClose ferme l’appareil de ligne ouverte spécifié.

Syntaxe

LONG lineClose(
  HLINE hLine
);

Paramètres

hLine

Gérez l’appareil en ligne ouverte à fermer. Une fois la ligne fermée, ce 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 :

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Remarques

Si une application appelle lineClose alors qu’elle a toujours des appels actifs sur la ligne ouverte, la propriété de l’application de ces appels est révoquée. Si l’application était le seul propriétaire de ces appels, les appels sont également supprimés. Il est recommandé pour une application de programmation de supprimer les appels qu’elle possède sur une ligne ouverte en renonçant explicitement à la propriété et/ou en supprimant ces appels avant de fermer la ligne.

Si la ligne a été fermée avec succès, un message LINE_LINEDEVSTATE est envoyé à toutes les applications qui surveillent la ligne status des modifications d’ouverture/fermeture. Les réponses asynchrones en suspens sont supprimées.

Les fournisseurs de services peuvent trouver utile ou nécessaire de récupérer de force des appareils de ligne à partir d’une application dont la ligne est ouverte. Cela peut être utile pour empêcher une application de monopoliser l’appareil de ligne pendant trop longtemps. Si cela se produit, un message LINE_CLOSE est envoyé à l’application, spécifiant le handle de ligne de l’appareil de ligne qui a été fermé.

La fonction lineOpen alloue des ressources à l’application appelante, et les applications peuvent être empêchées d’ouvrir une ligne si les ressources ne sont pas disponibles. Par conséquent, une application qui n’utilise qu’occasionnellement un appareil de ligne (par exemple, pour effectuer des appels sortants) doit fermer la ligne aux ressources libres et autoriser d’autres applications à ouvrir la ligne.