ITAgent::CreateSessionWithPIN, méthode (tapi3.h)

Article
08/26/2023

La méthode CreateSessionWithPIN crée une session d’agent pour le groupe et l’adresse ACD d’entrée, avec le numéro d’identification personnel (PIN).

Syntaxe

HRESULT CreateSessionWithPIN(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [in]  BSTR           pPIN,
  [out] ITAgentSession **ppAgentSession
);

Paramètres

[in] pACDGroup

Pointeur vers l’interface ITACDGroup .

[in] pAddress

Pointeur vers l’interface ITAddress pour l’objet disponible pour recevoir des appels ACD.

[in] pPIN

Pointeur vers une représentation BSTR du code confidentiel de l’agent.

[out] ppAgentSession

Pointeur vers la session créée.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
TAPI_E_CALLCENTER_NO_AGENT_ID	Agent non créé par CreateAgentWithID.
TAPI_E_TIMEOUT	L’opération a échoué, car la DLL TAPI 3 l’a expiré. L’intervalle de délai d’expiration est de deux minutes.
E_INVALIDARG	pPIN a la valeur NULL.
E_POINTER	Le paramètre pPIN ou ppAgentSession n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

L’application doit utiliser SysAllocString pour allouer de la mémoire pour pPIN et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

TAPI appelle la méthode AddRef sur l’interface ITAgentSession retournée par ITAgent::CreateSessionWithPIN. L’application doit appeler Release sur l’interface ITAgentSession pour libérer les ressources qui lui sont associées.

Configuration requise


Plateforme cible	Windows
En-tête	tapi3.h (inclure Tapi3.h)
Bibliothèque	Uuid.lib
DLL	Tapi3.dll

Voir aussi

ITAgent

ITAgent::CreateSession

ITAgentSession

Partager via