Metodo ITAgent::CreateSessionWithPIN (tapi3.h)

Articolo
03/08/2023

Il metodo CreateSessionWithPIN crea una nuova sessione agente per il gruppo ECD di input e l'indirizzo, con il PIN (Personal Identification Number).

Sintassi

HRESULT CreateSessionWithPIN(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [in]  BSTR           pPIN,
  [out] ITAgentSession **ppAgentSession
);

Parametri

[in] pACDGroup

Puntatore all'interfaccia ITACDGroup .

[in] pAddress

Puntatore all'interfaccia ITAddress per l'oggetto disponibile per la ricezione di chiamate ACD.

[in] pPIN

Puntatore a una rappresentazione BSTR del PIN dell'agente.

[out] ppAgentSession

Puntatore alla sessione creata.

Valore restituito

Questo metodo può restituire uno di questi valori.

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

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per pPIN e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

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

Requisiti


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

Vedi anche

ITAgent

ITAgent::CreateSession

ITAgentSession

Condividi tramite