Partager via


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

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.

Configuration requise

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

Voir aussi

CreateAgent

ITAgent

ITAgentHandler