lineCreateAgentA, fonction (tapi.h)
La fonction lineCreateAgent crée un objet Agent. 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_CREATEAGENT.
Syntaxe
LONG lineCreateAgentA(
HLINE hLine,
LPCSTR lpszAgentID,
LPCSTR lpszAgentPIN,
LPHAGENT lphAgent
);
Paramètres
hLine
Gérez l’appareil de ligne.
lpszAgentID
Pointeur vers une chaîne Unicode null-terminated contenant l’identificateur de l’agent. Utilisé lors de l’utilisation de systèmes ACD hérités. Avec un système ACD qui utilise la connexion utilisateur du système d’exploitation pour l’authentification, lpszAgentID est défini sur NULL.
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. Avec un système ACD qui utilise la connexion utilisateur du système d’exploitation pour l’authentification, lpszAgentPIN est défini sur NULL.
lphAgent
Gérez l’agent créé, retourné par le proxy ACD. Il incombe à l’application proxy du gestionnaire d’agents de générer et de maintenir l’unicité de cet identificateur.
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 lineCreateAgent 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 |