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

Vedi anche

LINEAGENTACTIVITYLIST

LINEAGENTCAPS

LINEAGENTGROUPLIST

LINEAGENTSESSIONINFO

LINEAGENTSESSIONLIST

LINEAGENTSTATUS

LINEQUEUELIST

LINE_PROXYREQUEST

lineProxyResponse