Funzione lineCreateAgentA (tapi.h)
La funzione lineCreateAgent crea un nuovo oggetto Agent. Genera un messaggio di LINE_PROXYREQUEST da inviare a un gestore di funzioni proxy registrato, facendo riferimento a una struttura LINEPROXYREQUEST di tipo LINEPROXYREQUEST_CREATEAGENT.
Sintassi
LONG lineCreateAgentA(
HLINE hLine,
LPCSTR lpszAgentID,
LPCSTR lpszAgentPIN,
LPHAGENT lphAgent
);
Parametri
hLine
Handle per il dispositivo line.
lpszAgentID
Puntatore a una stringa Unicode con terminazione Null contenente l'identificatore dell'agente. Usato quando si usano sistemi ACD legacy. Con un sistema ACD che usa l'account di accesso utente del sistema operativo per l'autenticazione, lpszAgentID è impostato su NULL.
lpszAgentPIN
Puntatore a una stringa Unicode con terminazione Null contenente il PIN o la password dell'agente. Usato quando si usano sistemi ACD legacy. Con un sistema ACD che usa l'account di accesso utente del sistema operativo per l'autenticazione, lpszAgentPIN è impostato su NULL.
lphAgent
Handle per l'agente creato, restituito dal proxy ACD. È responsabilità dell'applicazione proxy del gestore agente generare e mantenere l'univocità di questo identificatore.
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 lineCreateAgent come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |