lineGetConfRelatedCalls 함수(tapi.h)

아티클
03/05/2024

lineGetConfRelatedCalls 함수는 지정된 호출과 동일한 전화 회의 호출의 일부인 호출 핸들 목록을 반환합니다. 지정한 통화는 전화 회의 또는 전화 회의의 참가자 통화입니다. 애플리케이션에 아직 핸들이 없는 호출에 대해 새 핸들이 생성되고 애플리케이션에 해당 호출에 대한 모니터 권한이 부여됩니다.

구문

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

매개 변수

hCall

호출에 대한 핸들입니다. 전화 회의 또는 전화 회의 참가자 통화입니다. 회의 부모 호출의 경우 hCall 의 호출 상태는 모든 상태일 수 있습니다. 회의 참가자 통화의 경우 회의 상태여야 합니다.

lpCallList

LINECALLLIST 형식의 고정 크기 데이터 구조에 대한 포인터입니다. 요청이 성공적으로 완료되면 전화 회의의 모든 호출에 대한 호출 핸들이 이 구조로 반환됩니다. 목록의 첫 번째 호출은 전화 회의이고, 다른 호출은 참가자 호출입니다. 애플리케이션에는 아직 핸들이 없는 호출에 대한 모니터 권한이 부여됩니다. 애플리케이션에 이미 핸들이 있는 목록의 호출에 대한 권한은 변경되지 않습니다. lineGetConfRelatedCalls를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

참고 구조의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

지정된 통화는 전화 회의 핸들 또는 참가자 통화에 대한 핸들일 수 있습니다. 예를 들어 아직 전화 회의에 추가되지 않은 상담 전화는 회의의 일부가 아닙니다. 반환되는 목록의 첫 번째 항목은 전화 회의 핸들이고, 다른 핸들은 모든 참가자 호출입니다. 지정된 호출은 항상 목록에 반환된 호출 중 하나입니다. 애플리케이션에 아직 호출 핸들이 없는 목록의 호출에는 모니터 권한이 할당됩니다. 애플리케이션에 이미 핸들이 있는 호출에 대한 권한은 변경되지 않습니다. 애플리케이션은 lineSetCallPrivilege 를 사용하여 호출의 권한을 변경할 수 있습니다.

lineCompleteTransfer를 사용하여 회의에 호출이 추가된 직후 lineGetConfRelatedCalls가 호출되면 TAPI가 통화가 실제로 회의의 일부로 간주되기 전에 LINECALLSTATE_CONFERENCED 입력되었음을 나타내는 LINE_CALLSTATE 메시지를 수신하기 위해 대기하기 때문에 lineGetConfRelatedCalls는 관련 호출의 전체 목록을 반환하지 않을 수 있습니다( 즉, 전화 회의 상태는 서비스 공급자에 의해 확인됨). 애플리케이션이 LINE_CALLSTATE 메시지를 받은 후 lineGetConfRelatedCalls는 전체 정보를 반환합니다.

애플리케이션은 목록의 각 호출에 대해 lineGetCallInfo 및 lineGetCallStatus를 호출하여 호출 정보와 상태 각각 확인할 수 있습니다.