LINE_PROXYREQUEST message
Le message de LINE_PROXYREQUEST TAPI remet une requête à un gestionnaire de fonction proxy inscrit.
Paramètres
-
hDevice
-
Handle de l’application sur l’appareil de ligne sur lequel l’agent status a changé.
-
dwCallbackInstance
-
Le rappel instance fourni lors de l’ouverture de la ligne de l’appel.
-
dwParam1
-
Pointeur vers une structure LINEPROXYREQUEST contenant la demande à traiter par l’application de gestionnaire de proxy.
-
dwParam2
-
Réservé.
-
dwParam3
-
Réservé.
Valeur retournée
Pas de valeur de retour.
Notes
Le message LINE_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 demande doit être effectué dans le contexte de la fonction de rappel TAPI de l’application uniquement s’il peut être exécuté 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 l’ACD pbX ou tout autre service système pouvant entraîner un blocage), la demande doit être mise en file d’attente dans l’application et la fonction de rappel doit être supprimée pour éviter de retarder la réception d’autres messages TAPI par l’application.
Au moment où le LINE_PROXYREQUEST est remis au gestionnaire de proxy, TAPI a déjà retourné un résultat de fonction dwRequestID positif à l’application d’origine et débloqué le thread appelant pour poursuivre l’exécution. L’application attend un message LINE_REPLY , qui est généré automatiquement lorsque l’application gestionnaire de proxy appelle lineProxyResponse.
L’application ne doit pas libérer la mémoire pointée par lpProxyRequest. TAPI libère la mémoire pendant l’exécution de lineProxyResponse. L’application peut appeler lineProxyResponse une seule fois pour chaque message LINE_PROXYREQUEST .
Si l’application reçoit un message LINE_CLOSE alors qu’elle a des demandes de proxy en attente, elle doit appeler lineProxyResponse pour chaque requête en attente, en passant une valeur dwResult appropriée (telle que LINEERR_OPERATIONFAILED).
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
| En-tête |
|