TSPI_lineSendUserUserInfo, fonction (tspi.h)

Article
08/26/2023

La fonction TSPI_lineSendUserUserInfo envoie des informations utilisateur-utilisateur à la partie distante lors de l’appel spécifié.

Syntaxe

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

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Handle de l’appel sur lequel envoyer des informations utilisateur-utilisateur. L’état d’appel de hdCall peut être connecté, proposé, accepté ou ringback.

lpsUserUserInfo

Pointeur vers une chaîne Unicode terminée par un caractère Null contenant des informations utilisateur à envoyer à la partie distante. 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, y compris la marque de fin Null , des informations utilisateur-utilisateur dans lpsUserUserInfo.

Valeur retournée

Retourne dwRequestID, ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult de la ASYNC_COMPLETION correspondante est égal à zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Remarques

Cette fonction peut être utilisée pour envoyer des informations utilisateur-utilisateur à tout moment pendant un appel connecté. Si la taille des informations spécifiées à envoyer est supérieure à ce qui peut contenir dans un message réseau unique (comme dans R ISDN), le fournisseur de services est chargé de diviser les informations en une séquence de messages réseau chaînés (à l’aide de « plus de données »).

Les informations utilisateur-utilisateur peuvent également être envoyées dans le cadre de l’acceptation d’appel, du rejet d’appel, de la redirection des appels et lors de l’appel. Des informations utilisateur-utilisateur peuvent également être reçues. Les informations reçues sont signalées dans la structure LINECALLINFO de l’appel. Chaque fois que des informations utilisateur-utilisateur arrivent après l’offre d’appel ou avant la déconnexion d’appel, un message LINE_CALLINFO avec un paramètre UserUserInfo avertit TAPI que les informations utilisateur-utilisateur dans l’enregistrement d’informations d’appel ont changé. Si plusieurs messages réseau sont chaînés, les informations sont assemblées par le fournisseur de services et un seul message est envoyé à TAPI.