lineSetAgentGroup 함수(tapi.h)

  • 아티클

lineSetAgentGroup 함수는 에이전트가 특정 주소에 로그인되는 에이전트 그룹을 설정합니다.

구문

LONG lineSetAgentGroup(
  HLINE                hLine,
  DWORD                dwAddressID,
  LPLINEAGENTGROUPLIST lpAgentGroupList
);

매개 변수

hLine

줄 디바이스에 대한 핸들입니다.

dwAddressID

에이전트 정보를 변경할 주소의 식별자입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

lpAgentGroupList

현재 에이전트가 주소에 로그인될 그룹을 식별하는 LINEAGENTGROUPLIST 구조체에 대한 포인터입니다. 포인터가 NULL 이거나 표시된 구조의 그룹 수가 0이면 에이전트가 현재 로그인된 ACD 그룹에서 로그아웃됩니다.

목록의 LINEAGENTGROUPENTRY 항목에 있는 "이름" 필드는 이 함수의 용도로 무시됩니다. 로그인한 그룹의 컨트롤은 그룹 식별자 값만을 기반으로 합니다.

반환 값

비동기 작업이 시작되면 양수 요청 식별자를 반환합니다. 그렇지 않으면 함수는 다음 음수 오류 값 중 하나를 반환합니다.

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTGROUP, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPASSWORD, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi.h
라이브러리 Tapi32.lib
DLL Tapi32.dll

추가 정보

LINEAGENTGROUPENTRY

LINEAGENTGROUPLIST

보조 회선 서비스 함수

TAPI 2.2 참조 개요