ITAgentHandler::CreateAgentWithID, méthode (tapi3cc.h)

Article
08/26/2023

La méthode CreateAgentWithID crée un objet Agent basé sur un identificateur d’agent. Cet identificateur est une chaîne identifiant l’agent sur un système ACD hérité. Si le système nécessite également un code confidentiel ou un mot de passe pour la connexion aux groupes, vous utilisez cette méthode pour définir le code confidentiel ou le mot de passe.

Syntaxe

HRESULT CreateAgentWithID(
  [in]  BSTR    pID,
  [in]  BSTR    pPIN,
  [out] ITAgent **ppAgent
);

Paramètres

[in] pID

Pointeur vers BSTR contenant l’identificateur de l’agent.

[in] pPIN

Pointeur vers BSTR contenant le code confidentiel de l’agent.

[out] ppAgent

Pointeur vers l’interface ITAgent .

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_INVALIDARG	Le paramètre pPIN est NULL.
E_POINTER	Le paramètre ppAgent n’est pas un pointeur 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

L’application doit utiliser SysAllocString pour allouer de la mémoire pour les paramètres pID et pPIN , et utiliser SysFreeString pour libérer la mémoire lorsque les variables ne sont plus nécessaires.

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