LINEAGENTCAPS 구조체(tapi.h)

아티클
03/05/2024

LINEAGENTCAPS 구조는 ACD 에이전트의 기능을 설명합니다. lineGetAgentCaps 함수는 LINEAGENTCAPS 구조를 반환합니다.

구문

typedef struct lineagentcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwAgentHandlerInfoSize;
  DWORD dwAgentHandlerInfoOffset;
  DWORD dwCapsVersion;
  DWORD dwFeatures;
  DWORD dwStates;
  DWORD dwNextStates;
  DWORD dwMaxNumGroupEntries;
  DWORD dwAgentStatusMessages;
  DWORD dwNumAgentExtensionIDs;
  DWORD dwAgentExtensionIDListSize;
  DWORD dwAgentExtensionIDListOffset;
  GUID  ProxyGUID;
} LINEAGENTCAPS, *LPLINEAGENTCAPS;

멤버

dwTotalSize

이 데이터 구조에 할당된 총 크기(바이트)입니다.

dwNeededSize

요청된 모든 정보를 바이트 단위로 유지하는 데 필요한 크기입니다.

dwUsedSize

유용한 정보를 포함하는 이 데이터 구조의 부분 크기(바이트)입니다.

dwAgentHandlerInfoSize

에이전트 처리기 정보의 크기(바이트)입니다.

dwAgentHandlerInfoOffset

구조체의 시작 부분에서 에이전트 요청을 처리하는 서버 애플리케이션의 이름, 버전 또는 기타 식별 정보를 지정하는 null로 끝나는 문자열로 오프셋됩니다. 문자열의 크기는 dwAgentHandlerInfoSize로 지정됩니다.

dwCapsVersion

에이전트 처리기 애플리케이션이 이 구조체의 내용을 준비하는 데 사용한 TAPI 버전입니다. 호출 애플리케이션이 lineGetAgentCaps에 전달한 API 버전보다 크지 않습니다.

dwFeatures

LINEAGENTFEATURE_ 상수를 사용하여 이 줄에 사용할 수 있는 에이전트 관련 기능입니다. 지원되는 기능을 호출하려면 줄과 주소가 적절한 상태여야 합니다. 비트 위치의 0은 해당 기능을 사용할 수 없음을 나타냅니다. 하나는 줄이 작업에 적절한 상태인 경우 해당 기능을 사용할 수 있음을 나타냅니다. 이 필드를 사용하면 애플리케이션이 디바이스에서 지원될 수 있는 에이전트 기능을 검색할 수 있습니다(그리고 결코 지원될 수 없음).

dwStates

lineSetAgentState의 dwAgentState 매개 변수에 사용할 수 있는 상수를 LINEAGENTSTATE_. 지원되는 상태를 설정하려면 줄과 주소가 적절한 상태여야 합니다. 비트 위치의 0은 해당 상태를 사용할 수 없음을 나타냅니다. 하나는 줄이 상태가 의미 있는 적절한 상태인 경우 해당 상태를 사용할 수 있음을 나타냅니다. 이 필드를 사용하면 애플리케이션이 디바이스에서 지원될 수 있는 에이전트 상태(및 지원되지 않을 수 없음)를 검색할 수 있습니다.

dwNextStates

lineSetAgentState의 dwNextAgentState 매개 변수에 사용할 수 있는 상수를 LINEAGENTSTATE_. 지원되는 상태를 설정하려면 줄과 주소가 적절한 상태여야 합니다. 비트 위치의 0은 해당 상태를 사용할 수 없음을 나타냅니다. 하나는 줄이 상태가 의미 있는 적절한 상태인 경우 해당 상태를 사용할 수 있음을 나타냅니다. 이 필드를 사용하면 애플리케이션이 디바이스에서 지원될 수 있는 에이전트 상태(및 지원되지 않을 수 없음)를 검색할 수 있습니다.

dwMaxNumGroupEntries

주소에 동시에 로그인할 수 있는 최대 에이전트 식별자 수입니다. LINEAGENTGROUPLIST 구조에서 dwNumEntries 멤버로 lineSetAgentGroup에 전달할 수 있는 가장 높은 값을 결정합니다.

dwAgentStatusMessages

LINE_AGENTSTATUS 메시지의 dwParam2에서 애플리케이션에서 수신할 수 있는 LINEAGENTSTATUS_상수를 나타냅니다.

dwNumAgentExtensionIDs

ExtensionIDList 배열에 표시되는 LINEEXTENSIONID 구조체의 수입니다. 주소에서 에이전트 처리기별 확장이 지원되는 경우 값은 0입니다.

dwAgentExtensionIDListSize

에이전트 확장 ID 배열의 크기(바이트)입니다.

dwAgentExtensionIDListOffset

구조체의 시작 부분에서 LINEEXTENSIONID 구조체의 배열로 오프셋됩니다. 크기는 dwNumExtensionIDs times SIZEOF(LINEEXTENSIONID)입니다. 배열에는 주소에 대한 에이전트 핸들에서 지원하는 모든 에이전트 처리기별 확장에 대한 128비트 범용 고유 식별자가 나열됩니다. 사용 중인 확장은 lineAgentSpecific 함수에서 참조되고 이 테이블의 위치에 따라 메시지를 LINE_AGENTSPECIFIC , 첫 번째 항목은 항목 0이므로 에이전트 처리기가 항상 이 배열의 확장 식별자를 동일한 순서로 표시하는 것이 중요합니다. 배열의 크기는 dwAgentExtensionIDListOffset로 지정됩니다.

ProxyGUID

줄과 연결된 ACD 프록시의 GUID입니다. 이 요소는 TAPI 버전 2.2 이상을 협상하는 애플리케이션에만 노출됩니다.