TSPI_lineAccept, fonction (tspi.h)

Article
08/26/2023

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

Syntaxe

LONG TSPIAPI TSPI_lineAccept(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Handle de l’appel à accepter. L’état d’appel de hdCall peut être proposé.

lpsUserUserInfo

Pointeur vers une chaîne Unicode terminée par null contenant des informations utilisateur-utilisateur à envoyer à la partie distante dans le cadre de l’acceptation de l’appel. Ce pointeur a 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).

dwSize

Taille en octets des informations utilisateur-utilisateur dans lpsUserUserInfo. Si lpsUserUserInfo a la valeur NULL, dwSize est ignoré.

Valeur retournée

Retourne dwRequestID si la fonction est terminée de manière asynchrone ou un numéro d’erreur si une erreur se produit. Le paramètre lResult du ASYNC_COMPLETION correspondant est zéro si la fonction réussit ou un numéro d’erreur en cas d’erreur. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Remarques

La fonction TSPI_lineAccept est utilisée dans les environnements de téléphonie (tels que R ISDN) qui permettent de séparer les alertes associées aux appels entrants de l’offre initiale de l’appel. Lorsqu’un appel arrive, l’appel est d’abord proposé. Pendant une petite période, l’application cliente peut avoir la possibilité de rejeter l’appel à l’aide de TSPI_lineDrop, de rediriger l’appel vers une autre station à l’aide de TSPI_lineRedirect, de répondre à l’appel à l’aide de TSPI_lineAnswer ou d’accepter l’appel à l’aide de TSPI_lineAccept. Une fois qu’un appel a été accepté avec succès, l’alerte à la fois sur l’appareil appelé et l’appareil appelant commence, et généralement l’état de l’appel passe à l’état accepté . Le fournisseur de services doit définir l’indicateur LINEADDRCAPFLAGS_ACCEPTTOALERT dans le membre dwAddrCapFlags de la structure de données LINEADDRESSCAPS si l’application doit appeler TSPI_lineAccept pour que l’alerte commence.

Pour TAPI, les alertes sont signalées à l’aide du message LINE_LINEDEVSTATE avec l’indication de sonnerie .

TSPI_lineAccept peuvent également être pris en charge par les fournisseurs de services non-ISDN. La transition de l’état d’appel vers l’état accepté peut être utilisée par d’autres clients TAPI comme indication qu’une application a revendiqué la responsabilité de l’appel et a présenté l’appel à l’utilisateur.

L’application cliente a la possibilité d’envoyer des informations utilisateur-utilisateur au moment de l’acceptation. Même si des informations utilisateur-utilisateur peuvent être envoyées, il n’est souvent pas garanti que le réseau fournira ces informations à l’appelant. L’application cliente peut consulter les fonctionnalités d’appareil d’une ligne pour déterminer si l’acceptation d’appel est disponible.