lineAddToConference 함수(tapi.h)

아티클
08/26/2023

lineAddToConference 함수는 hConsultCall로 지정된 호출을 hConfCall로 지정된 전화 회의에 추가합니다.

구문

LONG lineAddToConference(
  HCALL hConfCall,
  HCALL hConsultCall
);

매개 변수

hConfCall

전화 회의에 대한 핸들입니다. 애플리케이션은 이 호출의 소유자여야 합니다. 전화 회의 통화의 모든 모니터링(미디어, 톤, 숫자)은 개별 참여 통화가 아닌 hConfCall에만 적용됩니다. hConfCall의 호출 상태는 OnHoldPendingConference 또는 onHold여야 합니다.

hConsultCall

전화 회의에 추가할 통화에 대한 핸들입니다. 애플리케이션은 이 호출의 소유자여야 합니다. 이 전화는 다른 회의의 부모이거나 회의에 참가할 수 없습니다. LINEADDRESSCAPS에 표시된 디바이스 기능에 따라 hConsultCall이 lineSetupConference 또는 linePrepareAddToConference를 사용하여 설정되지 않았을 수도 있습니다. hConsultCall의 호출 상태는 연결, onHold, 계속 또는 링백이어야 합니다. 많은 PBX를 사용하면 실제로 응답하기 전에 회의에 통화를 추가할 수 있습니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 LINE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_CONFERENCEFULL, LINEERR_NOTOWNER, LINEERR_INVALCONFCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

LINEERR_INVALCALLHANDLE 반환되면 추가된 호출에 대해 지정된 호출 핸들이 잘못되었습니다. hConsultCall 은 다른 회의의 부모이거나 이미 회의에 참가한 참가자입니다. hConsultCall은 다른 이유로 추가할 수 없습니다(예: lineSetupConference 또는 linePrepareAddToConference를 사용하여 설정되어야 함). 또는 hConsultCall 및 hConfCall 은 서로 다른 열린 줄에서 호출됩니다.

추가된 파티의 통화 핸들은 회의에 통화를 추가한 후에도 유효합니다. 일반적으로 전화 회의 상태는 회의 상태로 바뀌고 회의 통화의 상태는 일반적으로 연결됩니다. lineGetConfRelatedCalls를 사용하여 지정된 통화와 동일한 전화 회의의 일부인 통화 핸들 목록을 가져올 수 있습니다. 지정된 통화는 전화 회의 또는 전화 회의의 참가자 통화입니다. 애플리케이션에 아직 핸들이 없는 호출에 대해 새 핸들이 생성되고 애플리케이션에 해당 호출에 대한 모니터 권한이 부여됩니다. 개별 참여 통화에 대한 핸들은 나중에 lineRemoveFromConference를 사용하여 전화 회의에서 해당 파티를 제거하는 데 사용할 수 있습니다.

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

참고 회의의 일부인 모든 통화는 동일한 열린 줄에 있어야 합니다.

회의에 참여하는 통화의 통화 상태는 독립적이지 않습니다. 예를 들어 전화 회의를 중단하면 참여하는 모든 통화가 자동으로 유휴 상태가 될 수 있습니다. 애플리케이션은 회선의 디바이스 기능을 참조하여 사용할 수 있는 회의 제거 형식을 확인해야 합니다. 애플리케이션은 LINE_CALLSTATE 메시지를 추적하여 관련된 호출에 발생한 내용을 확인해야 합니다.

전화 회의는 lineSetupConference 또는 lineCompleteTransfer로 설정됩니다. 회의에 추가된 호출은 일반적으로 lineSetupConference 또는 linePrepareAddToConference를 사용하여 설정됩니다. 일부 스위치는 회의에 임의 호출을 추가할 수 있으며, lineMakeCall 을 사용하여 이러한 통화를 설정하고 (하드) 보류 중일 수 있습니다. 애플리케이션은 LINEADDRESSCAPS 구조체의 dwAddrCapFlags 멤버를 검사하여 허용되는 작업을 확인할 수 있습니다.