Metodo ITAgentHandler::CreateAgentWithID (tapi3cc.h)

  • Articolo

Il metodo CreateAgentWithID crea un oggetto Agent basato su un identificatore dell'agente. Questo identificatore è una stringa che identifica l'agente in un sistema ACD legacy. Se il sistema richiede anche un PIN o una password per l'accesso ai gruppi, usare questo metodo per impostare il PIN o la password.

Sintassi

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

Parametri

[in] pID

Puntatore a BSTR contenente l'identificatore dell'agente.

[in] pPIN

Puntatore a BSTR contenente il PIN dell'agente.

[out] ppAgent

Puntatore all'interfaccia ITAgent .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Significato
S_OK
 Il metodo è riuscito.
E_INVALIDARG
 Il parametro pPIN è NULL.
E_POINTER
 Il parametro ppAgent non è un puntatore valido.
E_OUTOFMEMORY
 Memoria insufficiente per eseguire l'operazione.
TAPI_E_TIMEOUT
 L'operazione non è riuscita perché la DLL TAPI 3 l'ha timeout. L'intervallo di timeout è di due minuti.

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per i parametri pID e pPIN e usare SysFreeString per liberare la memoria quando le variabili non sono più necessarie.

TAPI chiama il metodo AddRef nell'interfaccia ITAgent restituita da ITAgentHandler::CreateAgentWithID. L'applicazione deve chiamare Release nell'interfaccia ITAgent per liberare risorse associate.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione tapi3cc.h (includere Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

CreateAgent

ITAgent

ITAgentHandler