lineCreateAgentSessionA, fonction (tapi.h)
La fonction lineCreateAgentSession crée un objet AgentSession. Il génère un message LINE_PROXYREQUEST à envoyer à un gestionnaire de fonction proxy inscrit, référençant une structure LINEPROXYREQUEST de type LINEPROXYREQUEST_CREATEAGENTSESSION.
Syntaxe
LONG lineCreateAgentSessionA(
HLINE hLine,
HAGENT hAgent,
LPCSTR lpszAgentPIN,
DWORD dwWorkingAddressID,
LPGUID lpGroupID,
LPHAGENTSESSION lphAgentSession
);
Paramètres
hLine
Gérez l’appareil de ligne.
hAgent
Identificateur de l’agent pour lequel la session doit être créée.
lpszAgentPIN
Pointeur vers une chaîne Unicode null-terminated contenant le code confidentiel ou le mot de passe de l’agent. Utilisé lors de l’utilisation de systèmes ACD hérités qui nécessitent un code confidentiel distinct pour chaque session créée (ou groupe connecté). Avec un système ACD qui utilise la connexion utilisateur du système d’exploitation pour l’authentification, lpszAgentPIN est défini sur NULL.
dwWorkingAddressID
Identificateur de l’adresse sur laquelle l’agent recevra des appels pour cette session.
lpGroupID
Pointeur vers un GUID qui identifie le groupe pour lequel la session est créée.
lphAgentSession
Gérez la session d’agent créée, retournée par le proxy ACD. Il incombe à l’application proxy du gestionnaire d’agent de générer et de maintenir l’unicité de ces identificateurs.
Valeur de retour
Retourne un identificateur de demande si l’opération asynchrone démarre ; sinon, la fonction retourne l’une des valeurs d’erreur suivantes :
LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Remarques
Note
L’en-tête tapi.h définit lineCreateAgentSession comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | tapi.h |
| bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |