Metodo ITAgent::CreateSessionWithPIN (tapi3.h)
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 |
|---|---|
|
Il metodo è riuscito. |
|
Agente non creato da CreateAgentWithID. |
|
L'operazione non è riuscita perché la DLL TAPI 3 ha superato il timeout. L'intervallo di timeout è di due minuti. |
|
pPIN è NULL. |
|
Il parametro pPIN o ppAgentSession non è un puntatore valido. |
|
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 |