fonction lineSendUserUserInfo (tapi.h)

Article
08/26/2023

La fonction lineSendUserUserInfo envoie des informations utilisateur à la partie distante sur l’appel spécifié.

Syntaxe

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

Paramètres

hCall

Gérez l’appel sur lequel envoyer des informations utilisateur-utilisateur. L’application doit être propriétaire de l’appel. L’état de l’appel de hCall doit être connecté, proposé, accepté ou ringback.

lpsUserUserInfo

Pointeur vers une chaîne contenant des informations utilisateur-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). 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.

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_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

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 tenir dans un message réseau unique (comme dans ISDN), le fournisseur de services est responsable de la division des 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 refus d’appel et de la redirection des appels, ainsi que lors de la réalisation d’appels. Les informations utilisateur-utilisateur peuvent également être reçues. Les informations reçues sont disponibles via l’enregistrement d’informations d’appel de l’appel. Chaque fois que les informations utilisateur-utilisateur arrivent après l’offre d’appel ou avant la déconnexion de l’appel, un message LINE_CALLINFO avec un paramètre UserUserInfo avertit l’application 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é à l’application.

Cette fonction peut envoyer des données sur le câble sous forme non chiffrée ; par conséquent, une personne qui écoute le réseau peut être en mesure de lire les données. Le risque de sécurité lié à l’envoi des données en texte clair doit être pris en compte avant d’utiliser cette méthode.