fonction lineReleaseUserUserInfo (tapi.h)

Article
08/26/2023

La fonction lineReleaseUserUserInfo informe le fournisseur de services que l’application a traité les informations utilisateur-utilisateur contenues dans la structure LINECALLINFO et que les informations utilisateur-utilisateur reçues ultérieurement peuvent désormais être écrites dans cette structure. Le fournisseur de services envoie un message LINE_CALLINFO indiquant LINECALLINFOSTATE_USERUSERINFO lorsque de nouvelles informations sont disponibles.

Syntaxe

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Paramètres

hCall

Gérer l’appel. L’application doit être propriétaire de l’appel. L’état d’appel de hCall peut être n’importe quel état.

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_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

Remarques

La fonction lineReleaseUserUserInfo permet à l’application de contrôler le flux d’informations utilisateur-utilisateur entrantes sur une connexion ISDN. Lorsqu’un nouveau message complet d’informations utilisateur est reçu, le fournisseur de services informe l’application à l’aide d’un message LINE_CALLINFO (en spécifiant LINECALLINFOSTATE_USERUSERINFO). Un nombre quelconque d’applications peut examiner les informations (à l’aide de lineGetCallInfo), mais l’application propriétaire des contrôles d’appel lorsque les informations sont publiées afin que les informations suivantes puissent être signalées. Le fournisseur de services ne remplace pas les informations utilisateur-utilisateur précédentes dans LINECALLINFO par des informations plus récentes tant que lineReleaseUserUserInfo n’a pas été appelé. Il incombe au fournisseur de services de mettre en mémoire tampon les informations utilisateur-utilisateur reçues ultérieurement jusqu’à ce que les informations précédentes soient publiées par l’application propriétaire de l’appel.