_Message PROXYREQUEST de ligne

Le message _ PROXYREQUEST de ligne TAPI envoie une requête à un gestionnaire de fonctions proxy inscrit.

            

Paramètres

hDevice

Handle de l’application sur le périphérique de ligne sur lequel l’état de l’agent a changé.

dwCallbackInstance

Instance de rappel fournie lors de l’ouverture de la ligne de l’appel.

dwParam1

Pointeur vers une structure LINEPROXYREQUEST contenant la demande à traiter par l’application du gestionnaire de proxy.

dwParam2

Réservé.

dwParam3

Réservé.

Valeur de retour

Pas de valeur de retour.

Notes

Le message de ligne _ PROXYREQUEST est envoyé uniquement à la première application inscrite pour gérer les demandes de proxy du type remis.

L’application doit traiter la requête contenue dans la mémoire tampon du proxy et appeler lineProxyResponse pour retourner des données ou fournir des résultats. Le traitement de la requête doit être effectué dans le contexte de la fonction de rappel TAPI de l’application uniquement si elle peut être exécutée immédiatement, sans attendre la réponse d’une autre entité. Si l’application doit communiquer avec d’autres entités (par exemple, un fournisseur de services pour gérer les ACD basés sur PBX, ou tout autre service système qui peut entraîner un blocage), la demande doit être mise en file d’attente dans l’application et la fonction de rappel s’est arrêtée pour éviter de retarder la réception de messages TAPI supplémentaires par l’application.

Au moment où la ligne _ PROXYREQUEST est remise au gestionnaire proxy, TAPI a déjà retourné un résultat de fonction dwRequestID positif à l’application d’origine et a débloqué le thread appelant pour poursuivre l’exécution. L’application attend un message de _ réponse de ligne , qui est généré automatiquement lorsque l’application de gestionnaire proxy appelle lineProxyResponse.

L’application ne libère pas la mémoire vers laquelle pointe lpProxyRequest. L’interface TAPI libère de la mémoire pendant l’exécution de lineProxyResponse. L’application peut appeler lineProxyResponse exactement une fois pour chaque message de _ PROXYREQUEST de ligne .

Si l’application reçoit un message de _ fermeture de ligne alors qu’elle a des requêtes proxy en attente, elle doit appeler lineProxyResponse pour chaque demande en attente, en transmettant une valeur dwResult appropriée (telle que LINEERR _ OPERATIONFAILED).

Spécifications

Condition requise Valeur
Version TAPI
Nécessite TAPI 2,0 ou une version ultérieure
En-tête
TAPI. h

Voir aussi

fermeture de ligne _

réponse de ligne _

LINEPROXYREQUEST

lineProxyResponse