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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de