fonction lineDrop (tapi.h)

Article
03/13/2024

La fonction lineDrop supprime ou déconnecte l’appel spécifié. L’application a la possibilité de spécifier les informations utilisateur-utilisateur à transmettre dans le cadre de la déconnexion de l’appel.

Syntaxe

LONG lineDrop(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Paramètres

hCall

Gérez l’appel à supprimer. L’application doit être propriétaire de l’appel. L’état de l’appel de hCall peut être n’importe quel état, sauf inactif.

lpsUserUserInfo

Pointeur vers une chaîne contenant des informations utilisateur-utilisateur à envoyer à la partie distante dans le cadre de la déconnexion de l’appel. Ce pointeur peut avoir la valeur NULL si aucune information utilisateur ne doit être envoyée. Les informations utilisateur-utilisateur sont envoyées uniquement si elles sont prises en charge par le réseau sous-jacent (voir LINEDEVCAPS). Le champ de discrimination de protocole pour les informations utilisateur-utilisateur, si nécessaire, doit apparaître comme le premier octet de la mémoire tampon pointée par lpsUserUserInfo et doit être pris en compte dans dwSize.

dwSize

Taille des informations utilisateur-utilisateur dans lpsUserUserInfo, en octets. Si lpsUserUserInfo a la valeur NULL, aucune information utilisateur n’est envoyée à la partie appelante et dwSize est ignorée.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone, ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message LINE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED.

Remarques

Lors de l’appel de lineDrop, les appels associés peuvent également être affectés. Par exemple, la suppression d’une téléconférence peut supprimer tous les appels participants individuels. LINE_CALLSTATE messages sont envoyés à l’application pour tous les appels dont l’état de l’appel est affecté. Un appel supprimé passe généralement à l’état inactif . L’appel de lineDrop sur un appel dans l’état de l’offre rejette l’appel. Tous les réseaux téléphoniques n’offrent pas cette fonctionnalité.

Un appel dans l’état d’attente revient généralement à l’état connecté . Lors de la suppression de l’appel de consultation au tiers pour une téléconférence ou lors de la suppression du tiers lors d’une téléconférence établie précédemment, le fournisseur (et le changement) peut libérer le pont de conférence et rétablir le rappel à un appel bipartition normal. Si c’est le cas, hConfCall passe à l’état inactif et le seul appel participant restant passe à l’état connecté . Certains commutateurs « annulent » automatiquement l’autre appel.

L’application a la possibilité d’envoyer des informations utilisateur-utilisateur au moment de la suppression. Même si des informations utilisateur peuvent être envoyées, il n’y a aucune garantie que le réseau fournira ces informations à la partie distante.

Dans différentes configurations bridged ou party-line lorsque plusieurs parties sont sur l’appel, lineDrop peut ne pas effacer l’appel. Par exemple, dans une situation de pontage, une opération lineDrop peut ne pas réellement abandonner l’appel, car les status d’autres stations de l’appel peuvent régir ; au lieu de cela, l’appel peut simplement être remplacé par le mode LINECONNECTEDMODE_INACTIVE s’il reste connecté à d’autres stations.