fonction lineAccept (tapi.h)

Article
08/26/2023

La fonction lineAccept accepte l’appel proposé spécifié. Il peut éventuellement envoyer les informations utilisateur-utilisateur spécifiées à la partie appelante.

Syntaxe

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

Paramètres

hCall

Gérer l’appel à accepter. L’application doit être propriétaire de l’appel. L’état de l’appel de hCall doit être proposé.

lpsUserUserInfo

Pointeur vers une chaîne terminée par null contenant des informations utilisateur-utilisateur à envoyer à la partie distante dans le cadre de l’acceptation 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 membre discriminateur 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 la fin null ), 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 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_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED, LINEERR_USERUSERINFOTOOBIG.

Remarques

La fonction lineAccept est utilisée dans des environnements de téléphonie tels que le réseau isdn (Integrated Services Digital Network) qui permettent de séparer les alertes associées aux appels entrants de l’offre initiale de l’appel. Lorsqu’un appel arrive, il est d’abord proposé. Pendant un certain temps, l’application peut avoir la possibilité de rejeter l’appel à l’aide de lineDrop, de rediriger l’appel vers une autre station à l’aide de lineRedirect, de répondre à l’appel à l’aide de lineAnswer ou d’accepter l’appel à l’aide de lineAccept. Une fois qu’un appel a été accepté par une application, l’alerte commence à la fois à l’appareil appelé et à l’appareil appelant, et l’état de l’appel passe généralement à accepté.

L’alerte est signalée à l’application par le message LINE_LINEDEVSTATE avec l’indication de sonnerie .

La fonction lineAccept peut également être prise en charge par des fournisseurs de services non-ISDN. La transition de l’état de l’appel vers accepté peut être utilisée par d’autres applications comme indication qu’une autre application a revendiqué la responsabilité de l’appel et a présenté l’appel à l’utilisateur.

L’application a la possibilité d’envoyer des informations utilisateur-utilisateur au moment de l’acceptation. Même si des informations utilisateur sont 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’acceptation d’appel est disponible.