constantes LINEDISCONNECTMODE_

Les constantes d’indicateur de bits LINEDISCONNECTMODE_ décrivent différentes raisons pour une demande de déconnexion distante. Un mode de déconnexion est disponible en tant que status d’appel à l’application après la transition de l’état de l’appel vers déconnecté.

LINEDISCONNECTMODE_BADADDRESS

L’adresse de destination n’est pas valide.

LINEDISCONNECTMODE_BLOCKED

Impossible de connecter l’appel, car les appels provenant de l’adresse d’origine ne sont pas acceptés à l’adresse de destination. Cela diffère de LINEDISCONNECTMODE_REJECT dans la mesure où le blocage est implémenté dans le réseau (rejet passif) tandis qu’un rejet est implémenté dans l’équipement de destination (rejet actif). Le blocage peut être dû à une exclusion spécifique de l’adresse d’origine, ou au fait que la destination accepte les appels d’un ensemble sélectionné d’adresses d’origine (groupe d’utilisateurs fermé). (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_BLOCKED est approprié en tant que réponse de liste de blocage. Par exemple, un modem a reçu une réponse, a passé plus de six secondes sans détecter la sonnerie, n’a pas pu se connecter à un nombre défini de fois, détermine que le numéro de téléphone n’est pas valide à appeler et émet une réponse « liste de blocage ».

LINEDISCONNECTMODE_BUSY

La station de l’utilisateur distant est occupée.

LINEDISCONNECTMODE_CANCELLED

L’appel a été annulé. (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_CONGESTION

Le réseau est saturé.

LINEDISCONNECTMODE_DONOTDISTURB

Impossible de connecter l’appel, car la destination a appelé la fonctionnalité Ne pas déranger. (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_FORWARDED

L’appel a été transféré par le commutateur.

LINEDISCONNECTMODE_INCOMPATIBLE

L’équipement de station de l’utilisateur distant n’est pas compatible avec le type d’appel demandé.

LINEDISCONNECTMODE_NOANSWER

La station de l’utilisateur distant ne répond pas.

LINEDISCONNECTMODE_NODIALTONE

Une tonalité n’a pas été détectée dans un délai d’expiration défini par le fournisseur de services, à un moment où l’appel était attendu (par exemple, à un « W » dans la chaîne pouvant être appelée). Cela peut également se produire sans délai d’expiration défini par le fournisseur de services ou sans valeur spécifiée dans le membre dwWaitForDialTone de la structure LINEDIALPARAMS . (TAPI versions 1.4 et ultérieures)

LINEDISCONNECTMODE_NORMAL

Il s’agit d’une demande de déconnexion normale de la partie distante. L’appel s’est terminé normalement.

LINEDISCONNECTMODE_NUMBERCHANGED

Impossible de connecter l’appel, car le numéro de destination a été modifié, mais la redirection automatique vers le nouveau numéro n’est pas fournie. (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_OUTOFORDER

L’appel n’a pas pu être connecté ou a été déconnecté, car l’appareil de destination est hors service (défaillance matérielle). (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_PICKUP

L’appel a été récupéré d’ailleurs.

LINEDISCONNECTMODE_QOSUNAVAIL

L’appel n’a pas pu être connecté ou a été déconnecté, car la qualité minimale du service n’a pas pu être obtenue ou maintenue. Cela diffère de LINEDISCONNECTMODE_INCOMPATIBLE en ce que le manque de ressources peut être une condition temporaire à la destination. (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_REJECT

L’utilisateur distant a rejeté l’appel.

LINEDISCONNECTMODE_TEMPFAILURE

L’appel n’a pas pu être connecté ou a été déconnecté en raison d’une défaillance temporaire du réseau ; l’appel peut être retenté ultérieurement et devrait se terminer à terme. (TAPI versions 2.0 et ultérieures)

LINEDISCONNECTMODE_TEMPFAILURE est approprié comme réponse différée. Par exemple, un modem qui reçoit un signal occupé ou un nombre trop élevé de fois dans une période donnée conclut que le numéro ne doit pas être appelé à nouveau tant qu’un temps défini n’est pas écoulé et émet une réponse « différée ».

LINEDISCONNECTMODE_UNAVAIL

La raison de la déconnexion n’est pas disponible et ne sera pas connue ultérieurement.

LINEDISCONNECTMODE_UNKNOWN

La raison de la demande de déconnexion est inconnue, mais peut être connue ultérieurement.

LINEDISCONNECTMODE_UNREACHABLE

Impossible d’atteindre l’utilisateur distant.

Notes

Les 16 bits d’ordre supérieur peuvent être attribués pour les extensions spécifiques à l’appareil. Les 16 bits d’ordre inférieur sont réservés.

Une demande de déconnexion distante pour un appel donné entraîne la transition de l’état de l’appel vers l’état déconnecté et un message LINE_CALLSTATE est envoyé à l’application. Les informations LINEDISCONNECTMODE_ fournissent des détails sur la demande de déconnexion distante. Il est disponible dans la structure LINECALLSTATUS de l’appel lorsque l’appel est à l’état déconnecté. Pendant qu’un appel est dans cet état, l’application est toujours autorisée à interroger les informations et les status de l’appel. Par exemple, les informations utilisateur-utilisateur reçues dans le cadre de la déconnexion à distance sont alors disponibles. L’application peut effacer un appel déconnecté en supprimant l’appel.

Pour la compatibilité descendante, il incombe au fournisseur de services d’examiner la version de l’API négociée sur la ligne et de ne pas utiliser cette valeur LINEDISCONNECTMODE_ si elle n’est pas prise en charge sur la version négociée (LINEDISCONNECTMODE_NORMAL ou _UNKNOWN peuvent être utilisés à la place).

Spécifications

Condition requise	Valeur
Version TAPI	Nécessite TAPI 2.0 ou version ultérieure
En-tête	Tapi.h

Voir aussi

LINE_CALLSTATE

LINECALLSTATUS

LINEDIALPARAMS