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 |