fonction lineProxyMessage (tapi.h)

La fonction lineProxyMessage est utilisée par un gestionnaire de demandes de proxy inscrit pour générer des messages TAPI liés à son rôle. Par exemple, un gestionnaire d’agent ACD peut utiliser cette fonction pour générer des messages LINE_AGENTSTATUS reçus par toutes les applications dont la ligne spécifiée est ouverte. TAPI supprime la génération du message sur la ligne hLine spécifiée dans les paramètres de fonction.

Syntaxe

LONG lineProxyMessage(
  HLINE hLine,
  HCALL hCall,
  DWORD dwMsg,
  DWORD dwParam1,
  DWORD dwParam2,
  DWORD dwParam3
);

Paramètres

hLine

Gérez vers l’appareil de ligne ouverte. Cette valeur est convertie par TAPI en hLine appropriée pour chaque application qui reçoit le message.

hCall

Si le message est lié à un appel spécifique (ce qui n’est pas le cas, dans le cas de LINE_AGENTSTATUS), spécifie le handle du gestionnaire de proxy pour cet appel ; est défini sur NULL pour les messages non liés à un appel spécifique. Celle-ci est convertie par TAPI en hCall correct pour chaque application qui reçoit le message.

dwMsg

Message TAPI à générer. Il doit s’agir d’un message qui est autorisé à être généré par les gestionnaires de proxy.

dwParam1

Paramètre associé au message à envoyer.

dwParam2

Paramètre associé au message à envoyer.

dwParam3

Paramètre associé au message à envoyer.

Valeur retournée

Retourne zéro si la fonction réussit ou l’une de ces valeurs d’erreur négatives :

LINEERR_INVALLINEHANDLE, LINEERR_INVALCALLHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi.h
Bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

LINE_AGENTSTATUS

Fonctions de service de ligne supplémentaires

Vue d’ensemble de la référence TAPI 2.2