Estrutura LINEPROXYREQUEST (tapi.h)
A estrutura LINEPROXYREQUEST contém valores de parâmetro do aplicativo que está fazendo a solicitação de proxy. Várias funções de call center TAPI geram uma mensagem LINE_PROXYREQUEST que faz referência a uma estrutura LINEPROXYREQUEST.
Sintaxe
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;
Membros
dwSize
Número total de bytes alocados pelo TAPI para conter a estrutura LINEPROXYREQUEST . O membro dwTotalSize de qualquer estrutura contida em LINEPROXYREQUEST (por exemplo, LINEAGENTCAPS) reflete apenas o número de bytes alocados para essa estrutura específica. Tamanho total, em bytes, do bloco de parâmetros Params .
dwClientMachineNameSize
Tamanho da cadeia de caracteres de nome do computador cliente, em bytes, incluindo o caractere de terminação nula.
dwClientMachineNameOffset
Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo que identifica o computador cliente que fez essa solicitação. O tamanho da cadeia de caracteres é especificado por dwClientMachineNameSize.
dwClientUserNameSize
Tamanho da cadeia de caracteres de nome de usuário do cliente, em bytes, incluindo o caractere de terminação nula.
dwClientUserNameOffset
Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo que identifica o usuário em cuja conta o aplicativo está em execução no computador cliente. O tamanho da cadeia de caracteres é especificado por dwClientUserNameSize.
dwClientAppAPIVersion
Versão de API mais alta com suporte pelo aplicativo que fez a solicitação. O manipulador de proxy deve restringir o conteúdo de todos os dados retornados ao aplicativo para os membros e valores que foram definidos nesta ou versões anteriores do TAPI.
dwRequestType
Uma das constantes LINEPROXYREQUEST_. Identifica o tipo de função e o componente de união que define os dados restantes na estrutura.
SetAgentGroup
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENT.
SetAgentGroup.dwAddressID
Identificador do endereço para o qual o agente deve ser definido.
SetAgentGroup.GroupList
Estrutura do tipo LINEAGENTGROUPLIST. Os deslocamentos dentro dessa estrutura são relativos ao início de SetAgentGroup.GroupList em vez do início da estrutura LINEPROXYREQUEST .
SetAgentState
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENTSTATE.
SetAgentState.dwAddressID
Identificador do endereço para o qual o estado do agente deve ser definido.
SetAgentState.dwAgentState
Novo estado do agente ou zero para deixar o estado do agente inalterado.
SetAgentState.dwNextAgentState
Novo próximo estado do agente ou zero para usar o próximo estado padrão associado ao estado do agente especificado.
SetAgentActivity
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENTACTIVITY.
SetAgentActivity.dwAddressID
Identificador do endereço para o qual a atividade do agente deve ser definida.
SetAgentActivity.dwActivityID
Identificador da atividade que está sendo selecionada.
GetAgentCaps
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETAGENTCAPS.
GetAgentCaps.dwAddressID
Identificador do endereço para o qual os recursos do agente devem ser recuperados.
GetAgentCaps.AgentCaps
Estrutura do tipo LINEAGENTCAPS. Os deslocamentos dentro dessa estrutura são relativos ao início de GetAgentCaps.AgentCaps em vez do início da estrutura LINEPROXYREQUEST . O membro dwTotalSize é definido pelo TAPI e os bytes restantes são definidos como zero. O manipulador de proxy deve preencher dwNeededSize, dwUsedSize e os membros restantes conforme apropriado, antes de chamar lineProxyResponse.
GetAgentStatus
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENTGROUP.
GetAgentStatus.dwAddressID
Identificador do endereço para o qual o agente status deve ser recuperado.
GetAgentStatus.AgentStatus
Estrutura do tipo LINEAGENTSTATUS. Os deslocamentos dentro dessa estrutura são relativos ao início de GetAgentStatus.AgentStatus em vez do início da estrutura LINEPROXYREQUEST . O membro dwTotalSize é definido pelo TAPI e os bytes restantes são definidos como zero. O manipulador de proxy deve preencher dwNeededSize, dwUsedSize e os membros restantes conforme apropriado, antes de chamar lineProxyResponse.
AgentSpecific
Componente union usado quando dwRequestType é LINEPROXYREQUEST_AGENTSPECIFIC.
AgentSpecific.dwAddressID
Identificador do endereço para o qual o agente status deve ser recuperado.
AgentSpecific.dwAgentExtensionIDIndex
Índice da extensão do manipulador que está sendo invocada; a posição do identificador dentro da matriz de identificadores de extensão retornados em LINEAGENTCAPS.
AgentSpecific.dwSize
Tamanho total, em bytes, do bloco de parâmetros Params .
AgentSpecific.Params[1]
Bloco de memória que inclui o conteúdo passado para o manipulador do aplicativo. Se o manipulador deve retornar dados para o aplicativo, ele deve ser gravado nesse bloco de parâmetros antes de chamar lineProxyResponse.
GetAgentActivityList
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETAGENTACTIVITYLIST.
GetAgentActivityList.dwAddressID
Identificador do endereço para o qual a lista de atividades do agente deve ser recuperada.
GetAgentActivityList.ActivityList
Estrutura do tipo LINEAGENTACTIVITYLIST. Os deslocamentos dentro dessa estrutura são relativos ao início de GetAgentActivityList.ActivityList em vez do início da estrutura LINEPROXYREQUEST . O membro dwTotalSize é definido pelo TAPI e os bytes restantes são definidos como zero. O manipulador de proxy deve preencher dwNeededSize, dwUsedSize e os membros restantes conforme apropriado, antes de chamar lineProxyResponse.
GetAgentGroupList
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETAGENTGROUPLIST.
GetAgentGroupList.dwAddressID
Identificador do endereço para o qual a lista de grupos de agentes deve ser recuperada.
GetAgentGroupList.GroupList
Estrutura do tipo LINEAGENTGROUPLIST. Os deslocamentos dentro dessa estrutura são relativos ao início de GetAgentGroupList.GroupList em vez do início da estrutura LINEPROXYREQUEST . O membro dwTotalSize é definido pelo TAPI e os bytes restantes são definidos como zero. O manipulador de proxy deve preencher dwNeededSize, dwUsedSize e os membros restantes conforme apropriado, antes de chamar lineProxyResponse.
CreateAgent
Componente union usado quando dwRequestType é LINEPROXYREQUEST_CREATEAGENT.
CreateAgent.hAgent
Identificador exclusivo de um agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
CreateAgent.dwAgentIDSize
Tamanho da cadeia de caracteres de ID do agente, em bytes.
CreateAgent.dwAgentIDOffset
Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo que especifica a ID do agente. O tamanho da cadeia de caracteres é especificado por dwAgentIDSize.
CreateAgent.dwAgentPINSize
Tamanho da cadeia de caracteres de PIN, incluindo o terminador nulo , em bytes.
CreateAgent.dwAgentPINOffset
Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo que especifica o PIN ou a senha do agente. O tamanho da cadeia de caracteres é especificado por dwAgentPINSize.
SetAgentStateEx
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENTSTATEEX.
SetAgentStateEx.hAgent
Identificador exclusivo de um agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
SetAgentStateEx.dwAgentState
Uma das constantes LINEAGENTSTATEEX_.
SetAgentStateEx.dwNextAgentState
Uma das constantes LINEAGENTSTATEEX_.
SetAgentMeasurementPeriod
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD.
SetAgentMeasurementPeriod.hAgent
Identificador exclusivo de um agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
SetAgentMeasurementPeriod.dwMeasurementPeriod
Período para o qual a opção ou implementação armazena e calcula informações, em segundos. Por exemplo, dwNumberOfACDCalls contém o número de chamadas manipuladas pelo agente; dwMeasurementPeriod indica se esse valor referenciou as chamadas manipuladas na última hora, dia ou mês.
GetAgentInfo
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETAGENTINFO.
GetAgentInfo.hAgent
Identificador exclusivo de um agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
GetAgentInfo.AgentInfo
Estrutura do tipo LINEAGENTINFO.
CreateAgentSession
Componente union usado quando dwRequestType é LINEPROXYREQUEST_CREATEAGENTSESSION.
CreateAgentSession.hAgentSession
Identificador exclusivo para uma sessão de agente.
CreateAgentSession.dwAgentPINSize
Tamanho da cadeia de caracteres de PIN do agente, incluindo o terminador nulo , em bytes.
CreateAgentSession.dwAgentPINOffset
Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo que especifica o PIN ou a senha do agente. O tamanho dessa cadeia de caracteres é especificado por dwAgentPINSize.
CreateAgentSession.hAgent
Identificador exclusivo de um agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
CreateAgentSession.GroupID
Identificador universalmente exclusivo para um grupo ACD. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
CreateAgentSession.dwWorkingAddressID
Identificador do endereço no qual o agente receberá chamadas para esta sessão.
GetAgentSessionList
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETAGENTSESSIONLIST.
GetAgentSessionList.hAgent
Identificador exclusivo de um agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
GetAgentSessionList.SessionList
Estrutura do tipo LINEAGENTSESSIONLIST.
GetAgentSessionInfo
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETAGENTSESSIONINFO.
GetAgentSessionInfo.hAgentSession
Identificador exclusivo para uma sessão de agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
GetAgentSessionInfo.SessionInfo
Estrutura do tipo LINEAGENTSESSIONINFO.
SetAgentSessionState
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETAGENTSESSIONSTATE.
SetAgentSessionState.hAgentSession
Identificador exclusivo para uma sessão de agente. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
SetAgentSessionState.dwAgentSessionState
Uma das constantes LINEAGENTSESSIONSTATE_.
SetAgentSessionState.dwNextAgentSessionState
Uma das constantes LINEAGENTSESSIONSTATE_.
GetQueueList
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETQUEUELIST.
GetQueueList.GroupID
Identificador universalmente exclusivo para um grupo ACD. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
GetQueueList.QueueList
Estrutura do tipo LINEQUEUELIST.
SetQueueMeasurementPeriod
Componente union usado quando dwRequestType é LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD.
SetQueueMeasurementPeriod.dwQueueID
Identificador exclusivo de uma fila. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
SetQueueMeasurementPeriod.dwMeasurementPeriod
Período para o qual a opção ou implementação armazena e calcula informações, em segundos.
GetQueueInfo
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETQUEUEINFO.
GetQueueInfo.dwQueueID
Identificador exclusivo de uma fila. É responsabilidade do manipulador de agente gerar e manter a exclusividade desse identificador.
GetQueueInfo.QueueInfo
Estrutura do tipo LINEQUEUEINFO.
GetGroupList
Componente union usado quando dwRequestType é LINEPROXYREQUEST_GETGROUPLIST.
GetGroupList.GroupList
Estrutura do tipo LINEAGENTGROUPLIST.
Comentários
Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | tapi.h |