Metodo ITAgentHandler::CreateAgentWithID (tapi3.h)

Articolo
03/13/2024

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

Condividi tramite