Handles d’appel

Comme mentionné dans la vue d’ensemble de l’identificateur de session , un handle d’appel est le moyen par lequel une application TAPI 2.2 identifie une session de communication particulière. Lorsqu’une application lance une session, TAPI retourne un handle d’appel pour une utilisation dans d’autres opérations ou requêtes. Lorsqu’une application est avertie d’une session entrante, TAPI transmet également un handle d’appel.

Une fois qu’une session s’est terminée et que l’état de la session est inactif, le handle d’appel reste valide jusqu’à ce que l’application désalloue le handle ou que la ligne soit fermée. La ligne peut être fermée par l’application, ou elle peut recevoir un message LINE_CLOSE. Si une ligne est fermée, tous les handles d’appel aux appels sur la ligne deviennent instantanément non valides.

Une fois qu’un appel revient à l’état de inactif, l’application est toujours autorisée à lire la structure et l’état des informations de l’appel. Cela permet aux applications d’utiliser des opérations telles que lineGetCallInfo pour récupérer les informations d’appel à des fins de journalisation.

Lorsque l’application n’a plus d’utilisation pour le handle d’un appel inactif, elle doit appeler lineDeallocateCall pour libérer la mémoire allouée par le système associée à l’appel. TAPI alloue de la mémoire pour chaque appel pour chaque application qui a un handle à l’appel. Il est probable que les fournisseurs de services allouent également de la mémoire pour contenir les informations d’appel. La désallocation du handle d’appel d’une application permet à la bibliothèque et au fournisseur de services de récupérer ces ressources de mémoire. Le handle d’une application pour un appel devient void après une désallocation réussie.

L’application doit elle-même libérer de la mémoire liée à l’appel qu’elle a alloué à ses propres fins.