fonction lineSecureCall (tapi.h)

Article
08/26/2023

La fonction lineSecureCall sécurise l’appel contre toute interruption ou interférence pouvant affecter le flux multimédia de l’appel.

Syntaxe

LONG lineSecureCall(
  HCALL hCall
);

Paramètres

hCall

Gérer l’appel à sécuriser. 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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Remarques

Un appel peut être sécurisé pour éviter les interférences. Par exemple, dans un environnement analogique, les tonalités d’attente d’appel peuvent détruire une session de télécopie ou de modem sur l’appel d’origine. La fonction lineSecureCall permet de sécuriser un appel existant. La fonction lineMakeCall offre la possibilité de sécuriser l’appel à partir du moment de la configuration de l’appel. La sécurisation d’un appel reste en vigueur pendant toute la durée de l’appel.