Struttura LINEPROXYREQUEST (tapi.h)
La struttura LINEPROXYREQUEST contiene i valori dei parametri dell'applicazione che effettua la richiesta proxy. Più funzioni del call center TAPI generano un messaggio LINE_PROXYREQUEST che fa riferimento a una struttura LINEPROXYREQUEST .
Sintassi
typedef struct lineproxyrequest_tag {
DWORD dwSize;
DWORD dwClientMachineNameSize;
DWORD dwClientMachineNameOffset;
DWORD dwClientUserNameSize;
DWORD dwClientUserNameOffset;
DWORD dwClientAppAPIVersion;
DWORD dwRequestType;
union {
struct {
DWORD dwAddressID;
LINEAGENTGROUPLIST GroupList;
} SetAgentGroup;
struct {
DWORD dwAddressID;
DWORD dwAgentState;
DWORD dwNextAgentState;
} SetAgentState;
struct {
DWORD dwAddressID;
DWORD dwActivityID;
} SetAgentActivity;
struct {
DWORD dwAddressID;
LINEAGENTCAPS AgentCaps;
} GetAgentCaps;
struct {
DWORD dwAddressID;
LINEAGENTSTATUS AgentStatus;
} GetAgentStatus;
struct {
DWORD dwAddressID;
DWORD dwAgentExtensionIDIndex;
DWORD dwSize;
BYTE Params[1];
} AgentSpecific;
struct {
DWORD dwAddressID;
LINEAGENTACTIVITYLIST ActivityList;
} GetAgentActivityList;
struct {
DWORD dwAddressID;
LINEAGENTGROUPLIST GroupList;
} GetAgentGroupList;
struct {
HAGENT hAgent;
DWORD dwAgentIDSize;
DWORD dwAgentIDOffset;
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
} CreateAgent;
struct {
HAGENT hAgent;
DWORD dwAgentState;
DWORD dwNextAgentState;
} SetAgentStateEx;
struct {
HAGENT hAgent;
DWORD dwMeasurementPeriod;
} SetAgentMeasurementPeriod;
struct {
HAGENT hAgent;
LINEAGENTINFO AgentInfo;
} GetAgentInfo;
struct {
HAGENTSESSION hAgentSession;
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
HAGENT hAgent;
GUID GroupID;
DWORD dwWorkingAddressID;
} CreateAgentSession;
struct {
HAGENT hAgent;
LINEAGENTSESSIONLIST SessionList;
} GetAgentSessionList;
struct {
HAGENTSESSION hAgentSession;
LINEAGENTSESSIONINFO SessionInfo;
} GetAgentSessionInfo;
struct {
HAGENTSESSION hAgentSession;
DWORD dwAgentSessionState;
DWORD dwNextAgentSessionState;
} SetAgentSessionState;
struct {
GUID GroupID;
LINEQUEUELIST QueueList;
} GetQueueList;
struct {
DWORD dwQueueID;
DWORD dwMeasurementPeriod;
} SetQueueMeasurementPeriod;
struct {
DWORD dwQueueID;
LINEQUEUEINFO QueueInfo;
} GetQueueInfo;
struct {
LINEAGENTGROUPLIST GroupList;
} GetGroupList;
};
} LINEPROXYREQUEST, *LPLINEPROXYREQUEST;
Members
dwSize
Numero totale di byte allocati da TAPI per contenere la struttura LINEPROXYREQUEST . Il membro dwTotalSize di qualsiasi struttura contenuta all'interno di LINEPROXYREQUEST (ad esempio, LINEAGENTCAPS) riflette solo il numero di byte allocati per tale struttura specifica. Dimensioni totali, in byte, del blocco dei parametri Params .
dwClientMachineNameSize
Dimensioni della stringa del nome del computer client, in byte, incluso il carattere null-terminazione.
dwClientMachineNameOffset
Offset dall'inizio della struttura a una stringa con terminazione null che identifica il computer client che ha effettuato questa richiesta. Le dimensioni della stringa sono specificate da dwClientMachineNameSize.
dwClientUserNameSize
Dimensioni della stringa nome utente client, in byte, incluso il carattere null-terminazione.
dwClientUserNameOffset
Offset dall'inizio della struttura a una stringa con terminazione null che identifica l'utente sotto il cui account l'applicazione è in esecuzione nel computer client. Le dimensioni della stringa sono specificate da dwClientUserNameSize.
dwClientAppAPIVersion
Versione API più elevata supportata dall'applicazione che ha effettuato la richiesta. Il gestore proxy deve limitare il contenuto di tutti i dati restituiti all'applicazione a tali membri e valori definiti in questo oggetto o versioni precedenti di TAPI.
dwRequestType
Una delle costanti LINEPROXYREQUEST_. Identifica il tipo di funzione e il componente unione che definisce i dati rimanenti nella struttura.
SetAgentGroup
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENT.
SetAgentGroup.dwAddressID
Identificatore dell'indirizzo per il quale deve essere impostato l'agente.
SetAgentGroup.GroupList
Struttura di tipo LINEAGENTGROUPLIST. Gli offset all'interno di questa struttura sono relativi all'inizio di SetAgentGroup.GroupList anziché all'inizio della struttura LINEPROXYREQUEST .
SetAgentState
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENTSTATE.
SetAgentState.dwAddressID
Identificatore dell'indirizzo per il quale deve essere impostato lo stato dell'agente.
SetAgentState.dwAgentState
Nuovo stato agente o zero per lasciare invariato lo stato dell'agente.
SetAgentState.dwNextAgentState
Nuovo stato dell'agente successivo o zero per usare lo stato successivo predefinito associato allo stato dell'agente specificato.
SetAgentActivity
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENTACTIVITY.
SetAgentActivity.dwAddressID
Identificatore dell'indirizzo per il quale deve essere impostata l'attività dell'agente.
SetAgentActivity.dwActivityID
Identificatore dell'attività selezionata.
GetAgentCaps
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETAGENTCAPS.
GetAgentCaps.dwAddressID
Identificatore dell'indirizzo per il quale devono essere recuperate le funzionalità dell'agente.
GetAgentCaps.AgentCaps
Struttura di tipo LINEAGENTCAPS. Gli offset all'interno di questa struttura sono relativi all'inizio di GetAgentCaps.AgentCaps anziché all'inizio della struttura LINEPROXYREQUEST . Il membro dwTotalSize è impostato da TAPI e i byte rimanenti impostati su zero. Il gestore proxy deve compilare dwNeededSize, dwUsedSize e i membri rimanenti, come appropriato, prima di chiamare lineProxyResponse.
GetAgentStatus
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENTGROUP.
GetAgentStatus.dwAddressID
Identificatore dell'indirizzo per il quale deve essere recuperato lo stato dell'agente.
GetAgentStatus.AgentStatus
Struttura di tipo LINEAGENTSTATUS. Gli offset all'interno di questa struttura sono relativi all'inizio di GetAgentStatus.AgentStatus anziché all'inizio della struttura LINEPROXYREQUEST . Il membro dwTotalSize è impostato da TAPI e i byte rimanenti impostati su zero. Il gestore proxy deve compilare dwNeededSize, dwUsedSize e i membri rimanenti, come appropriato, prima di chiamare lineProxyResponse.
AgentSpecific
Componente union usato quando dwRequestType è LINEPROXYREQUEST_AGENTSPECIFIC.
AgentSpecific.dwAddressID
Identificatore dell'indirizzo per il quale deve essere recuperato lo stato dell'agente.
AgentSpecific.dwAgentExtensionIDIndex
Indice dell'estensione del gestore richiamato; posizione dell'identificatore all'interno della matrice di identificatori di estensione restituiti in LINEAGENTCAPS.
AgentSpecific.dwSize
Dimensioni totali, in byte, del blocco dei parametri Params .
AgentSpecific.Params[1]
Blocco di memoria che include il contenuto passato al gestore dall'applicazione. Se il gestore deve restituire i dati all'applicazione, è necessario scrivere in questo blocco di parametri prima di chiamare lineProxyResponse.
GetAgentActivityList
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETAGENTACTIVITYLIST.
GetAgentActivityList.dwAddressID
Identificatore dell'indirizzo per il quale deve essere recuperato l'elenco di attività dell'agente.
GetAgentActivityList.ActivityList
Struttura di tipo LINEAGENTACTIVITYLIST. Gli offset all'interno di questa struttura sono relativi all'inizio di GetAgentActivityList.ActivityList anziché all'inizio della struttura LINEPROXYREQUEST . Il membro dwTotalSize è impostato da TAPI e i byte rimanenti impostati su zero. Il gestore proxy deve compilare dwNeededSize, dwUsedSize e i membri rimanenti, come appropriato, prima di chiamare lineProxyResponse.
GetAgentGroupList
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETAGENTGROUPLIST.
GetAgentGroupList.dwAddressID
Identificatore dell'indirizzo per il quale deve essere recuperato l'elenco di gruppi di agenti.
GetAgentGroupList.GroupList
Struttura di tipo LINEAGENTGROUPLIST. Gli offset all'interno di questa struttura sono relativi all'inizio di GetAgentGroupList.GroupList anziché all'inizio della struttura LINEPROXYREQUEST . Il membro dwTotalSize è impostato da TAPI e i byte rimanenti impostati su zero. Il gestore proxy deve compilare dwNeededSize, dwUsedSize e i membri rimanenti, come appropriato, prima di chiamare lineProxyResponse.
CreateAgent
Componente union usato quando dwRequestType è LINEPROXYREQUEST_CREATEAGENT.
CreateAgent.hAgent
Identificatore univoco per un agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
CreateAgent.dwAgentIDSize
Dimensioni della stringa ID agente, in byte.
CreateAgent.dwAgentIDOffset
Offset dall'inizio della struttura a una stringa con terminazione null che specifica l'ID dell'agente. Le dimensioni della stringa sono specificate da dwAgentIDSize.
CreateAgent.dwAgentPINSize
Dimensioni della stringa PIN, inclusa la terminazione Null , in byte.
CreateAgent.dwAgentPINOffset
Offset dall'inizio della struttura a una stringa con terminazione null che specifica il PIN o la password dell'agente. Le dimensioni della stringa sono specificate da dwAgentPINSize.
SetAgentStateEx
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENTSTATEEX.
SetAgentStateEx.hAgent
Identificatore univoco per un agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
SetAgentStateEx.dwAgentState
Una delle costanti LINEAGENTSTATEEX_.
SetAgentStateEx.dwNextAgentState
Una delle costanti LINEAGENTSTATEEX_.
SetAgentMeasurementPeriod
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD.
SetAgentMeasurementPeriod.hAgent
Identificatore univoco per un agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
SetAgentMeasurementPeriod.dwMeasurementPeriod
Periodo per il quale l'opzione o l'implementazione archivia e calcola le informazioni, in secondi. Ad esempio, dwNumberOfACDCalls contiene il numero di chiamate gestite dall'agente; dwMeasurementPeriod indica se questo valore fa riferimento alle chiamate gestite nell'ultima ora, giorno o mese.
GetAgentInfo
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETAGENTINFO.
GetAgentInfo.hAgent
Identificatore univoco per un agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
GetAgentInfo.AgentInfo
Struttura di tipo LINEAGENTINFO.
CreateAgentSession
Componente union usato quando dwRequestType è LINEPROXYREQUEST_CREATEAGENTSESSION.
CreateAgentSession.hAgentSession
Identificatore univoco per una sessione dell'agente.
CreateAgentSession.dwAgentPINSize
Dimensioni della stringa PIN dell'agente, inclusa la terminazione Null , in byte.
CreateAgentSession.dwAgentPINOffset
Offset dall'inizio della struttura a una stringa con terminazione null che specifica il PIN o la password dell'agente. Le dimensioni di questa stringa vengono specificate da dwAgentPINSize.
CreateAgentSession.hAgent
Identificatore univoco per un agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
CreateAgentSession.GroupID
Identificatore universalmente univoco per un gruppo ACD. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
CreateAgentSession.dwWorkingAddressID
Identificatore dell'indirizzo in cui l'agente riceverà chiamate per questa sessione.
GetAgentSessionList
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETAGENTSESSIONLIST.
GetAgentSessionList.hAgent
Identificatore univoco per un agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
GetAgentSessionList.SessionList
Struttura di tipo LINEAGENTSESSIONLIST.
GetAgentSessionInfo
Componente Union usato quando dwRequestType è LINEPROXYREQUEST_GETAGENTSESSIONINFO.
GetAgentSessionInfo.hAgentSession
Identificatore univoco per una sessione dell'agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
GetAgentSessionInfo.SessionInfo
Struttura di tipo LINEAGENTSESSIONINFO.
SetAgentSessionState
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETAGENTSESSIONSTATE.
SetAgentSessionState.hAgentSession
Identificatore univoco per una sessione dell'agente. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
SetAgentSessionState.dwAgentSessionState
Una delle costanti LINEAGENTSESSIONSTATE_.
SetAgentSessionState.dwNextAgentSessionState
Una delle costanti LINEAGENTSESSIONSTATE_.
GetQueueList
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETQUEUELIST.
GetQueueList.GroupID
Identificatore univoco universale per un gruppo ACD. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
GetQueueList.QueueList
Struttura di tipo LINEQUEUELIST.
SetQueueMeasurementPeriod
Componente union usato quando dwRequestType è LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD.
SetQueueMeasurementPeriod.dwQueueID
Identificatore univoco per una coda. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
SetQueueMeasurementPeriod.dwMeasurementPeriod
Periodo per il quale l'opzione o l'implementazione archivia e calcola le informazioni, in secondi.
GetQueueInfo
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETQUEUEINFO.
GetQueueInfo.dwQueueID
Identificatore univoco per una coda. È responsabilità del gestore dell'agente generare e mantenere l'univocità di questo identificatore.
GetQueueInfo.QueueInfo
Struttura di tipo LINEQUEUEINFO.
GetGroupList
Componente union usato quando dwRequestType è LINEPROXYREQUEST_GETGROUPLIST.
GetGroupList.GroupList
Struttura di tipo LINEAGENTGROUPLIST.
Commenti
Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | tapi.h |