Metodo ITAgentHandler::CreateAgentWithID (tapi3.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 ha superato il 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 le risorse associate.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi3.h (include Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

CreateAgent

ITAgent

ITAgentHandler