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

Article
03/02/2024

La méthode CreateSession crée une session d’agent pour le groupe et l’adresse ACD d’entrée.

Syntaxe

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

Paramètres

[in] pACDGroup

Pointeur vers l’interface ITACDGroup .

[in] pAddress

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

[out] ppAgentSession

Pointeur vers l’interface ITAgentSession pour l’objet créé.

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	Le paramètre ppAgentSession n’est pas un pointeur valide.
E_UNEXPECTED	Impossible d’ouvrir une ligne pour l’adresse cible.
E_INVALIDARG	L’argument pACDGroup ou pAddress n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
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.

Remarques

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

Certains environnements téléphoniques nécessitent un numéro d’identification personnel pour ouvrir une session. Consultez CreateSessionWithPIN.