LINEPROXYREQUEST 구조체(tapi.h)
LINEPROXYREQUEST 구조체에는 프록시 요청을 만드는 애플리케이션의 매개 변수 값이 포함되어 있습니다. 여러 TAPI 콜 센터 함수는LINEPROXYREQUEST 구조를 참조하는 LINE_PROXYREQUEST 메시지를 생성합니다.
구문
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;
멤버
dwSize
LINEPROXYREQUEST 구조를 포함하기 위해 TAPI에서 할당한 총 바이트 수입니다. LINEPROXYREQUEST(예: LINEAGENTCAPS)에 포함된 구조체의 dwTotalSize 멤버는 특정 구조에 할당된 바이트 수만 반영합니다. Params 매개 변수 블록의 총 크기(바이트)입니다.
dwClientMachineNameSize
null 종료 문자를 포함하여 클라이언트 머신 이름 문자열의 크기(바이트)입니다.
dwClientMachineNameOffset
구조체의 시작 부분에서 이 요청을 수행한 클라이언트 컴퓨터를 식별하는 null로 끝나는 문자열로 오프셋됩니다. 문자열의 크기는 dwClientMachineNameSize로 지정됩니다.
dwClientUserNameSize
null 종료 문자를 포함하여 클라이언트 사용자 이름 문자열의 크기(바이트)입니다.
dwClientUserNameOffset
구조체의 시작 부분에서 애플리케이션이 클라이언트 머신에서 실행 중인 계정의 사용자를 식별하는 null로 끝나는 문자열로 오프셋됩니다. 문자열의 크기는 dwClientUserNameSize로 지정됩니다.
dwClientAppAPIVersion
요청을 수행한 애플리케이션에서 지원하는 가장 높은 API 버전입니다. 프록시 처리기는 애플리케이션에 반환된 데이터의 내용을 이 버전 또는 이전 버전의 TAPI에 정의된 해당 멤버 및 값으로 제한해야 합니다.
dwRequestType
LINEPROXYREQUEST_ 상수 중 하나입니다. 구조체의 나머지 데이터를 정의하는 함수 형식 및 공용 구조체 구성 요소를 식별합니다.
SetAgentGroup
dwRequestType이 LINEPROXYREQUEST_SETAGENT 때 사용되는 공용 구조체 구성 요소입니다.
SetAgentGroup.dwAddressID
에이전트를 설정할 주소의 식별자입니다.
SetAgentGroup.GroupList
LINEAGENTGROUPLIST 형식의 구조입니다. 이 구조체 내의 오프셋은 LINEPROXYREQUEST 구조체의 시작이 아닌 SetAgentGroup.GroupList의 시작을 기준으로 합니다.
SetAgentState
dwRequestType이 LINEPROXYREQUEST_SETAGENTSTATE 때 사용되는 공용 구조체 구성 요소입니다.
SetAgentState.dwAddressID
에이전트 상태를 설정할 주소의 식별자입니다.
SetAgentState.dwAgentState
에이전트 상태를 변경하지 않은 상태로 두는 새 에이전트 상태 또는 0입니다.
SetAgentState.dwNextAgentState
새 다음 에이전트 상태 또는 지정된 에이전트 상태와 연결된 기본 다음 상태를 사용하는 0입니다.
SetAgentActivity
dwRequestType이 LINEPROXYREQUEST_SETAGENTACTIVITY 때 사용되는 공용 구조체 구성 요소입니다.
SetAgentActivity.dwAddressID
에이전트 활동을 설정할 주소의 식별자입니다.
SetAgentActivity.dwActivityID
선택 중인 활동의 식별자입니다.
GetAgentCaps
dwRequestType이 LINEPROXYREQUEST_GETAGENTCAPS 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentCaps.dwAddressID
에이전트 기능을 검색할 주소의 식별자입니다.
GetAgentCaps.AgentCaps
LINEAGENTCAPS 형식의 구조입니다. 이 구조체 내의 오프셋은 LINEPROXYREQUEST 구조체의 시작이 아닌 GetAgentCaps.AgentCaps의 시작을 기준으로 합니다. dwTotalSize 멤버는 TAPI로 설정되고 나머지 바이트는 0으로 설정됩니다. 프록시 처리기는 lineProxyResponse를 호출하기 전에 dwNeedSize, dwUsedSize 및 나머지 멤버를 적절하게 채워야 합니다.
GetAgentStatus
dwRequestType이 LINEPROXYREQUEST_SETAGENTGROUP 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentStatus.dwAddressID
에이전트 상태 검색할 주소의 식별자입니다.
GetAgentStatus.AgentStatus
LINEAGENTSTATUS 형식의 구조입니다. 이 구조체 내의 오프셋은 LINEPROXYREQUEST 구조체의 시작이 아닌 GetAgentStatus.AgentStatus의 시작을 기준으로 합니다. dwTotalSize 멤버는 TAPI로 설정되고 나머지 바이트는 0으로 설정됩니다. 프록시 처리기는 lineProxyResponse를 호출하기 전에 dwNeedSize, dwUsedSize 및 나머지 멤버를 적절하게 채워야 합니다.
AgentSpecific
dwRequestType이 LINEPROXYREQUEST_AGENTSPECIFIC 때 사용되는 공용 구조체 구성 요소입니다.
AgentSpecific.dwAddressID
에이전트 상태 검색할 주소의 식별자입니다.
AgentSpecific.dwAgentExtensionIDIndex
호출되는 처리기 확장의 인덱스입니다. LINEAGENTCAPS에서 반환된 확장 식별자 배열 내에서 식별자의 위치입니다.
AgentSpecific.dwSize
Params 매개 변수 블록의 총 크기(바이트)입니다.
AgentSpecific.Params[1]
애플리케이션에서 처리기에 전달된 내용을 포함하는 메모리 블록입니다. 처리기가 애플리케이션에 데이터를 반환하는 경우 lineProxyResponse를 호출하기 전에 이 매개 변수 블록에 기록해야 합니다.
GetAgentActivityList
dwRequestType이 LINEPROXYREQUEST_GETAGENTACTIVITYLIST 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentActivityList.dwAddressID
에이전트 활동 목록을 검색할 주소의 식별자입니다.
GetAgentActivityList.ActivityList
LINEAGENTACTIVITYLIST 형식의 구조입니다. 이 구조체 내의 오프셋은 LINEPROXYREQUEST 구조체의 시작이 아닌 GetAgentActivityList.ActivityList의 시작을 기준으로 합니다. dwTotalSize 멤버는 TAPI로 설정되고 나머지 바이트는 0으로 설정됩니다. 프록시 처리기는 lineProxyResponse를 호출하기 전에 dwNeedSize, dwUsedSize 및 나머지 멤버를 적절하게 채워야 합니다.
GetAgentGroupList
dwRequestType이 LINEPROXYREQUEST_GETAGENTGROUPLIST 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentGroupList.dwAddressID
에이전트 그룹 목록을 검색할 주소의 식별자입니다.
GetAgentGroupList.GroupList
LINEAGENTGROUPLIST 형식의 구조입니다. 이 구조체 내의 오프셋은 LINEPROXYREQUEST 구조체의 시작이 아닌 GetAgentGroupList.GroupList의 시작을 기준으로 합니다. dwTotalSize 멤버는 TAPI로 설정되고 나머지 바이트는 0으로 설정됩니다. 프록시 처리기는 lineProxyResponse를 호출하기 전에 dwNeedSize, dwUsedSize 및 나머지 멤버를 적절하게 채워야 합니다.
CreateAgent
dwRequestType이 LINEPROXYREQUEST_CREATEAGENT 때 사용되는 공용 구조체 구성 요소입니다.
CreateAgent.hAgent
에이전트의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
CreateAgent.dwAgentIDSize
에이전트 ID 문자열의 크기(바이트)입니다.
CreateAgent.dwAgentIDOffset
구조체의 시작 부분에서 에이전트의 ID를 지정하는 null로 끝나는 문자열로 오프셋됩니다. 문자열의 크기는 dwAgentIDSize로 지정됩니다.
CreateAgent.dwAgentPINSize
null 종결자를 포함한 PIN 문자열의 크기(바이트)입니다.
CreateAgent.dwAgentPINOffset
구조체의 시작 부분에서 에이전트의 PIN 또는 암호를 지정하는 null로 끝나는 문자열로 오프셋됩니다. 문자열의 크기는 dwAgentPINSize로 지정됩니다.
SetAgentStateEx
dwRequestType이 LINEPROXYREQUEST_SETAGENTSTATEEX 때 사용되는 공용 구조체 구성 요소입니다.
SetAgentStateEx.hAgent
에이전트의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
SetAgentStateEx.dwAgentState
SetAgentStateEx.dwNextAgentState
SetAgentMeasurementPeriod
dwRequestType이 LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD 때 사용되는 공용 구조체 구성 요소입니다.
SetAgentMeasurementPeriod.hAgent
에이전트의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
SetAgentMeasurementPeriod.dwMeasurementPeriod
스위치 또는 구현이 정보를 저장하고 계산하는 기간(초)입니다. 예를 들어 dwNumberOfACDCalls 는 에이전트가 처리한 호출 수를 보유합니다. dwMeasurementPeriod 는 이 값이 지난 1시간, 일 또는 월에 처리된 호출을 참조하는지 여부를 나타냅니다.
GetAgentInfo
dwRequestType이 LINEPROXYREQUEST_GETAGENTINFO 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentInfo.hAgent
에이전트의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
GetAgentInfo.AgentInfo
LINEAGENTINFO 형식의 구조체입니다.
CreateAgentSession
dwRequestType이 LINEPROXYREQUEST_CREATEAGENTSESSION 때 사용되는 공용 구조체 구성 요소입니다.
CreateAgentSession.hAgentSession
에이전트 세션의 고유 식별자입니다.
CreateAgentSession.dwAgentPINSize
null 종결자를 포함한 에이전트 PIN 문자열의 크기(바이트)입니다.
CreateAgentSession.dwAgentPINOffset
구조체의 시작 부분에서 에이전트의 PIN 또는 암호를 지정하는 null로 끝나는 문자열로 오프셋됩니다. 이 문자열의 크기는 dwAgentPINSize로 지정됩니다.
CreateAgentSession.hAgent
에이전트의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
CreateAgentSession.GroupID
ACD 그룹에 대한 범용 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
CreateAgentSession.dwWorkingAddressID
에이전트가 이 세션에 대한 호출을 받을 주소의 식별자입니다.
GetAgentSessionList
dwRequestType이 LINEPROXYREQUEST_GETAGENTSESSIONLIST 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentSessionList.hAgent
에이전트의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
GetAgentSessionList.SessionList
LINEAGENTSESSIONLIST 형식의 구조입니다.
GetAgentSessionInfo
dwRequestType이 LINEPROXYREQUEST_GETAGENTSESSIONINFO 때 사용되는 공용 구조체 구성 요소입니다.
GetAgentSessionInfo.hAgentSession
에이전트 세션의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
GetAgentSessionInfo.SessionInfo
LINEAGENTSESSIONINFO 형식의 구조체입니다.
SetAgentSessionState
dwRequestType이 LINEPROXYREQUEST_SETAGENTSESSIONSTATE 때 사용되는 공용 구조체 구성 요소입니다.
SetAgentSessionState.hAgentSession
에이전트 세션의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
SetAgentSessionState.dwAgentSessionState
LINEAGENTSESSIONSTATE_ 상수 중 하나입니다.
SetAgentSessionState.dwNextAgentSessionState
LINEAGENTSESSIONSTATE_ 상수 중 하나입니다.
GetQueueList
dwRequestType이 LINEPROXYREQUEST_GETQUEUELIST 때 사용되는 공용 구조체 구성 요소입니다.
GetQueueList.GroupID
ACD 그룹에 대한 범용 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
GetQueueList.QueueList
LINEQUEUELIST 형식의 구조입니다.
SetQueueMeasurementPeriod
dwRequestType이 LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD 때 사용되는 공용 구조체 구성 요소입니다.
SetQueueMeasurementPeriod.dwQueueID
큐의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
SetQueueMeasurementPeriod.dwMeasurementPeriod
스위치 또는 구현이 정보를 저장하고 계산하는 기간(초)입니다.
GetQueueInfo
dwRequestType이 LINEPROXYREQUEST_GETQUEUEINFO 때 사용되는 공용 구조체 구성 요소입니다.
GetQueueInfo.dwQueueID
큐의 고유 식별자입니다. 이 식별자의 고유성을 생성하고 유지하는 것은 에이전트 처리기의 책임입니다.
GetQueueInfo.QueueInfo
LINEQUEUEINFO 형식의 구조체입니다.
GetGroupList
dwRequestType이 LINEPROXYREQUEST_GETGROUPLIST 때 사용되는 공용 구조체 구성 요소입니다.
GetGroupList.GroupList
LINEAGENTGROUPLIST 형식의 구조입니다.
설명
주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | tapi.h |