funzione lineCreateAgentSessionA (tapi.h)
La funzione lineCreateAgentSession crea un nuovo oggetto AgentSession. Genera un messaggio LINE_PROXYREQUEST da inviare a un gestore di funzioni proxy registrato, facendo riferimento a una struttura LINEPROXYREQUEST di tipo LINEPROXYREQUEST_CREATEAGENTSESSION.
Sintassi
LONG lineCreateAgentSessionA(
HLINE hLine,
HAGENT hAgent,
LPCSTR lpszAgentPIN,
DWORD dwWorkingAddressID,
LPGUID lpGroupID,
LPHAGENTSESSION lphAgentSession
);
Parametri
hLine
Gestire il dispositivo linea.
hAgent
Identificatore dell'agente per cui verrà creata la sessione.
lpszAgentPIN
Puntatore a una stringa Unicode con terminazione null contenente il PIN dell'agente o la password. Usato quando si usano sistemi ACD legacy che richiedono un PIN separato per ogni sessione creata (o gruppo connesso). Con un sistema ACD che usa l'account di accesso utente del sistema operativo per l'autenticazione, lpszAgentPIN è impostato su NULL.
dwWorkingAddressID
Identificatore dell'indirizzo in cui l'agente riceverà chiamate per questa sessione.
lpGroupID
Puntatore a un GUID che identifica il gruppo per cui viene creata la sessione.
lphAgentSession
Gestire la sessione dell'agente creata, restituita dal proxy ACD. È responsabilità dell'applicazione proxy del gestore agente generare e mantenere l'univocità di questi identificatori.
Valore restituito
Restituisce un identificatore di richiesta se l'operazione asincrona viene avviata; in caso contrario, la funzione restituisce uno dei valori di errore seguenti:
LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Commenti
Nota
L'intestazione tapi.h definisce lineCreateAgentSession come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |