Metodo ITAgent::CreateSession (tapi3.h)

Articolo
03/02/2024

Il metodo CreateSession crea una nuova sessione agente per il gruppo e l'indirizzo ACD di input.

Sintassi

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

Parametri

[in] pACDGroup

Puntatore all'interfaccia ITACDGroup .

[in] pAddress

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

[out] ppAgentSession

Puntatore all'interfaccia ITAgentSession per l'oggetto creato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro ppAgentSession non è un puntatore valido.
E_UNEXPECTED	Impossibile aprire una riga per l'indirizzo di destinazione.
E_INVALIDARG	L'argomento pACDGroup o pAddress non è 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

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

Alcuni ambienti telefonici richiedono un numero di identificazione personale per aprire una sessione. Vedere CreateSessionWithPIN.