fonction TSPI_lineReleaseUserUserInfo (tspi.h)

Article
03/03/2024

La fonction TSPI_lineReleaseUserUserInfo informe le fournisseur de services que les informations utilisateur-utilisateur contenues dans la structure LINECALLINFO ont été traitées 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 TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Le handle du fournisseur de services à l’appel pour lequel les informations utilisateur-utilisateur doivent être publiées. L’état de l’appel de hdCall peut être n’importe lequel.

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est 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_NOMEM, LINEERR_RESOURCEUNAVAIL.

Remarques

La fonction TSPI_lineReleaseUserUserInfo permet de contrôler le flux d’informations utilisateur entrantes sur une connexion ISDN. Lorsqu’un nouveau message complet d’informations utilisateur est reçu, le fournisseur de services informe TAPI à l’aide d’un message LINE_CALLINFO (spécifiant LINECALLINFOSTATE_USERUSERINFO). Les informations utilisateur-utilisateur et d’autres champs de LINECALLINFO peuvent être examinés par plusieurs appels à TSPI_lineGetCallInfo. Le fournisseur de services ne doit pas remplacer les informations utilisateur-utilisateur précédentes dans LINECALLINFO par des informations plus récentes tant que TSPI_lineReleaseUserUserInfo n’a pas été appelé. Le fournisseur de services doit mettre en mémoire tampon les informations utilisateur reçues ultérieurement jusqu’à ce que les informations précédentes soient publiées. Toutes les informations mises en mémoire tampon restantes peuvent être ignorées lorsque TSPI_lineCloseCall est appelé.

Si cette fonction est appelée alors qu’il n’existe aucune information utilisateur dans LINECALLINFO, le fournisseur de services doit néanmoins retourner une indication de réussite.

À des fins de compatibilité descendante, TAPI retourne automatiquement LINEERR_OPERATIONUNAVAIL si cette fonction est appelée pour un appel sur une ligne sous le contrôle d’un fournisseur de services qui n’exporte pas la fonction.