fonction lineAnswer (tapi.h)

Article
08/26/2023

La fonction lineAnswer répond à l’appel d’offre spécifié.

Syntaxe

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

Paramètres

hCall

Gérer l’appel à répondre. L’application doit être propriétaire de cet appel. L’état de l’appel de hCall doit être proposé ou accepté.

lpsUserUserInfo

Pointeur vers une chaîne terminée par null contenant des informations utilisateur à envoyer à la partie distante au moment où l’appel reçoit une réponse. Ce pointeur peut être laissé null si aucune information utilisateur-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 (y compris le terminateur Null ), en octets Si lpsUserUserInfo a la valeur NULL, aucune information utilisateur n’est envoyée à la partie appelante et dwSize est ignoré.

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 nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Remarques

Lorsqu’un nouvel appel arrive, les applications qui s’intéressent à l’appel reçoivent un message LINE_CALLSTATE pour fournir le nouveau descripteur d’appel et informer l’application de l’état de l’appel et des privilèges pour le nouvel appel (par exemple, moniteur ou propriétaire). L’application disposant du privilège propriétaire pour l’appel peut répondre à cet appel à l’aide de lineAnswer. Une fois que l’appel a été correctement répondu, l’appel passe généralement à l’état connecté . Initialement, une seule application reçoit le privilège de propriétaire pour l’appel entrant.

Dans certains environnements de téléphonie (comme R ISDN), où les alertes utilisateur sont distinctes de l’offre d’appel, l’application peut avoir la possibilité d’accepter un appel avant de répondre ou de rejeter ou de rediriger l’appel de l’offre.

Si un appel arrive (est proposé) au moment où un autre appel est déjà actif, l’appel de lineAnswer se connecte au nouvel appel. L’effet sur l’appel actif existant dépend des fonctionnalités de l’appareil de la ligne. Le premier appel peut être non affecté, il peut être automatiquement supprimé ou automatiquement mis en attente. Les messages LINE_CALLSTATE appropriés enregistrent des transitions d’état vers l’application pour les deux appels.

Dans une situation de pontage, si un appel est connecté mais dans l’état LINECONNECTEDMODE_INACTIVE, il peut être joint à l’aide de la fonction lineAnswer .

L’application a la possibilité d’envoyer des informations utilisateur-utilisateur au moment de la réponse. Même si des informations utilisateur-utilisateur peuvent être envoyées, il n’y a aucune garantie que le réseau fournira ces informations à la partie appelante. Une application doit consulter les fonctionnalités de l’appareil d’une ligne pour déterminer si l’envoi d’informations utilisateur-utilisateur lors de la réponse à l’appel est disponible.