Compartir a través de


Estructura LINEPROXYREQUEST (tapi.h)

La estructura LINEPROXYREQUEST contiene valores de parámetro de la aplicación que realiza la solicitud de proxy. Varias funciones del centro de llamadas TAPI generan un mensaje LINE_PROXYREQUEST que hace referencia a una estructura LINEPROXYREQUEST .

Sintaxis

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;

Miembros

dwSize

Número total de bytes asignados por TAPI para contener la estructura LINEPROXYREQUEST . El miembro dwTotalSize de cualquier estructura contenida en LINEPROXYREQUEST (por ejemplo, LINEAGENTCAPS) refleja solo el número de bytes asignados para esa estructura específica. Tamaño total, en bytes, del bloque de parámetros Params .

dwClientMachineNameSize

Tamaño de la cadena de nombre del equipo cliente, en bytes, incluido el carácter de terminación null.

dwClientMachineNameOffset

Desplazamiento desde el principio de la estructura a una cadena terminada en null que identifica al equipo cliente que realizó esta solicitud. DwClientMachineNameSize especifica el tamaño de la cadena.

dwClientUserNameSize

Tamaño de la cadena de nombre de usuario del cliente, en bytes, incluido el carácter de terminación null.

dwClientUserNameOffset

Desplazamiento desde el principio de la estructura a una cadena terminada en null que identifica al usuario en cuya cuenta se ejecuta la aplicación en el equipo cliente. DwClientUserNameSize especifica el tamaño de la cadena.

dwClientAppAPIVersion

Versión de API más alta compatible con la aplicación que realizó la solicitud. El controlador de proxy debe restringir el contenido de los datos devueltos a la aplicación a los miembros y valores definidos en esta versión o versiones anteriores de TAPI.

dwRequestType

Una de las constantes de LINEPROXYREQUEST_. Identifica el tipo de función y el componente de unión que define los datos restantes de la estructura.

SetAgentGroup

Componente de unión que se usa cuando dwRequestType está LINEPROXYREQUEST_SETAGENT.

SetAgentGroup.dwAddressID

Identificador de la dirección para la que se va a establecer el agente.

SetAgentGroup.GroupList

Estructura de tipo LINEAGENTGROUPLIST. Los desplazamientos dentro de esta estructura son relativos al principio de SetAgentGroup.GroupList en lugar del principio de la estructura LINEPROXYREQUEST .

SetAgentState

Componente de unión que se usa cuando dwRequestType está LINEPROXYREQUEST_SETAGENTSTATE.

SetAgentState.dwAddressID

Identificador de la dirección para la que se va a establecer el estado del agente.

SetAgentState.dwAgentState

Nuevo estado del agente o cero para dejar el estado del agente sin cambios.

SetAgentState.dwNextAgentState

Nuevo estado del agente siguiente o cero para usar el siguiente estado predeterminado asociado al estado del agente especificado.

SetAgentActivity

Componente union usado cuando dwRequestType es LINEPROXYREQUEST_SETAGENTACTIVITY.

SetAgentActivity.dwAddressID

Identificador de la dirección para la que se va a establecer la actividad del agente.

SetAgentActivity.dwActivityID

Identificador de la actividad que se selecciona.

GetAgentCaps

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_GETAGENTCAPS.

GetAgentCaps.dwAddressID

Identificador de la dirección para la que se van a recuperar las funcionalidades del agente.

GetAgentCaps.AgentCaps

Estructura de tipo LINEAGENTCAPS. Los desplazamientos dentro de esta estructura son relativos al principio de GetAgentCaps.AgentCaps en lugar del principio de la estructura LINEPROXYREQUEST . TapI establece el miembro dwTotalSize y los bytes restantes establecidos en cero. El controlador de proxy debe rellenar dwNeededSize, dwUsedSize y los miembros restantes según corresponda, antes de llamar a lineProxyResponse.

GetAgentStatus

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_SETAGENTGROUP.

GetAgentStatus.dwAddressID

Identificador de la dirección para la que se va a recuperar el estado del agente.

GetAgentStatus.AgentStatus

Estructura de tipo LINEAGENTSTATUS. Los desplazamientos dentro de esta estructura son relativos al principio de GetAgentStatus.AgentStatus en lugar del principio de la estructura LINEPROXYREQUEST . TapI establece el miembro dwTotalSize y los bytes restantes establecidos en cero. El controlador de proxy debe rellenar dwNeededSize, dwUsedSize y los miembros restantes según corresponda, antes de llamar a lineProxyResponse.

AgentSpecific

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_AGENTSPECIFIC.

AgentSpecific.dwAddressID

Identificador de la dirección para la que se va a recuperar el estado del agente.

AgentSpecific.dwAgentExtensionIDIndex

Índice de la extensión de controlador que se está invocando; posición del identificador dentro de la matriz de identificadores de extensión devueltos en LINEAGENTCAPS.

AgentSpecific.dwSize

Tamaño total, en bytes, del bloque de parámetros Params .

AgentSpecific.Params[1]

Bloque de memoria que incluye el contenido pasado al controlador desde la aplicación. Si el controlador es devolver datos a la aplicación, debe escribirse en este bloque de parámetros antes de llamar a lineProxyResponse.

GetAgentActivityList

Componente union usado cuando dwRequestType es LINEPROXYREQUEST_GETAGENTACTIVITYLIST.

GetAgentActivityList.dwAddressID

Identificador de la dirección para la que se va a recuperar la lista de actividad del agente.

GetAgentActivityList.ActivityList

Estructura de tipo LINEAGENTACTIVITYLIST. Los desplazamientos dentro de esta estructura son relativos al principio de GetAgentActivityList.ActivityList en lugar del principio de la estructura LINEPROXYREQUEST . TapI establece el miembro dwTotalSize y los bytes restantes establecidos en cero. El controlador de proxy debe rellenar dwNeededSize, dwUsedSize y los miembros restantes según corresponda, antes de llamar a lineProxyResponse.

GetAgentGroupList

Componente de unión que se usa cuando dwRequestType está LINEPROXYREQUEST_GETAGENTGROUPLIST.

GetAgentGroupList.dwAddressID

Identificador de la dirección para la que se va a recuperar la lista de grupos de agentes.

GetAgentGroupList.GroupList

Estructura de tipo LINEAGENTGROUPLIST. Los desplazamientos dentro de esta estructura son relativos al principio de GetAgentGroupList.GroupList en lugar del principio de la estructura LINEPROXYREQUEST . TapI establece el miembro dwTotalSize y los bytes restantes establecidos en cero. El controlador de proxy debe rellenar dwNeededSize, dwUsedSize y los miembros restantes según corresponda, antes de llamar a lineProxyResponse.

CreateAgent

Componente de unión que se usa cuando dwRequestType es LINEPROXYREQUEST_CREATEAGENT.

CreateAgent.hAgent

Identificador único de un agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

CreateAgent.dwAgentIDSize

Tamaño de la cadena de identificador de agente, en bytes.

CreateAgent.dwAgentIDOffset

Desplazamiento desde el principio de la estructura a una cadena terminada en null que especifica el identificador del agente. DwAgentIDSize especifica el tamaño de la cadena.

CreateAgent.dwAgentPINSize

Tamaño de la cadena DE PIN, incluido el terminador null , en bytes.

CreateAgent.dwAgentPINOffset

Desplazamiento desde el principio de la estructura a una cadena terminada en null que especifica el PIN o la contraseña del agente. DwAgentPINSize especifica el tamaño de la cadena.

SetAgentStateEx

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_SETAGENTSTATEEX.

SetAgentStateEx.hAgent

Identificador único de un agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

SetAgentStateEx.dwAgentState

Una de las constantes de LINEAGENTSTATEEX_.

SetAgentStateEx.dwNextAgentState

Una de las constantes de LINEAGENTSTATEEX_.

SetAgentMeasurementPeriod

Componente de unión que se usa cuando dwRequestType está LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD.

SetAgentMeasurementPeriod.hAgent

Identificador único de un agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

SetAgentMeasurementPeriod.dwMeasurementPeriod

Período para el que el modificador o la implementación almacena y calcula información, en segundos. Por ejemplo, dwNumberOfACDCalls contiene el número de llamadas que controla el agente; dwMeasurementPeriod indica si este valor hace referencia a las llamadas controladas en la última hora, día o mes.

GetAgentInfo

Componente de unión que se usa cuando dwRequestType está LINEPROXYREQUEST_GETAGENTINFO.

GetAgentInfo.hAgent

Identificador único de un agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

GetAgentInfo.AgentInfo

Estructura del tipo LINEAGENTINFO.

CreateAgentSession

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_CREATEAGENTSESSION.

CreateAgentSession.hAgentSession

Identificador único de una sesión de agente.

CreateAgentSession.dwAgentPINSize

Tamaño de la cadena de PIN del agente, incluido el terminador NULL , en bytes.

CreateAgentSession.dwAgentPINOffset

Desplazamiento desde el principio de la estructura a una cadena terminada en null que especifica el PIN o la contraseña del agente. DwAgentPINSize especifica el tamaño de esta cadena.

CreateAgentSession.hAgent

Identificador único de un agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

CreateAgentSession.GroupID

Identificador único universal para un grupo de ACD. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

CreateAgentSession.dwWorkingAddressID

Identificador de la dirección en la que el agente recibirá llamadas para esta sesión.

GetAgentSessionList

Componente union usado cuando dwRequestType es LINEPROXYREQUEST_GETAGENTSESSIONLIST.

GetAgentSessionList.hAgent

Identificador único de un agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

GetAgentSessionList.SessionList

Estructura de tipo LINEAGENTSESSIONLIST.

GetAgentSessionInfo

Componente de unión que se usa cuando dwRequestType es LINEPROXYREQUEST_GETAGENTSESSIONINFO.

GetAgentSessionInfo.hAgentSession

Identificador único de una sesión de agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

GetAgentSessionInfo.SessionInfo

Estructura de tipo LINEAGENTSESSIONINFO.

SetAgentSessionState

Componente union usado cuando dwRequestType es LINEPROXYREQUEST_SETAGENTSESSIONSTATE.

SetAgentSessionState.hAgentSession

Identificador único de una sesión de agente. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

SetAgentSessionState.dwAgentSessionState

Una de las constantes LINEAGENTSESSIONSTATE_.

SetAgentSessionState.dwNextAgentSessionState

Una de las constantes LINEAGENTSESSIONSTATE_.

GetQueueList

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_GETQUEUELIST.

GetQueueList.GroupID

Identificador único universal para un grupo de ACD. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

GetQueueList.QueueList

Estructura de tipo LINEQUEUELIST.

SetQueueMeasurementPeriod

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD.

SetQueueMeasurementPeriod.dwQueueID

Identificador único de una cola. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

SetQueueMeasurementPeriod.dwMeasurementPeriod

Período para el que el modificador o la implementación almacena y calcula información, en segundos.

GetQueueInfo

Componente union usado cuando dwRequestType es LINEPROXYREQUEST_GETQUEUEINFO.

GetQueueInfo.dwQueueID

Identificador único de una cola. Es responsabilidad del controlador del agente generar y mantener la unicidad de este identificador.

GetQueueInfo.QueueInfo

Estructura de tipo LINEQUEUEINFO.

GetGroupList

Componente union usado cuando dwRequestType está LINEPROXYREQUEST_GETGROUPLIST.

GetGroupList.GroupList

Estructura de tipo LINEAGENTGROUPLIST.

Comentarios

Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

Requisitos

Requisito Valor
Header tapi.h

Consulte también

LINEAGENTACTIVITYLIST

LINEAGENTCAPS

LINEAGENTGROUPLIST

LINEAGENTSESSIONINFO

LINEAGENTSESSIONLIST

LINEAGENTSTATUS

LINEQUEUELIST

LINE_PROXYREQUEST

lineProxyResponse