lineCompleteTransfer 함수(tapi.h)

아티클
08/26/2023

lineCompleteTransfer 함수는 상담 통화에 연결된 당사자에게 지정된 통화의 전송을 완료합니다.

구문

LONG lineCompleteTransfer(
  HCALL   hCall,
  HCALL   hConsultCall,
  LPHCALL lphConfCall,
  DWORD   dwTransferMode
);

매개 변수

hCall

전송할 호출에 대한 핸들입니다. 애플리케이션은 이 호출의 소유자여야 합니다. hCall의 호출 상태는 onHold 또는 onHoldPendingTransfer여야 합니다.

hConsultCall

전송 대상과의 연결을 나타내는 호출에 대한 핸들입니다. 애플리케이션은 이 호출의 소유자여야 합니다. hConsultCall의 호출 상태는 연결, 링백, 사용 중 또는 진행 중이어야 합니다.

lphConfCall

hCall 핸들을 반환할 수 있는 메모리 위치에 대한 포인터입니다. dwTransferMode가 LINETRANSFERMODE_CONFERENCE 경우 새로 만든 전화 회의는 lphConfCall에 반환되고 애플리케이션은 전화 회의 통화의 유일한 소유자가 됩니다. 그렇지 않으면 TAPI에서 이 매개 변수를 무시합니다.

dwTransferMode

시작된 전송 요청을 확인하는 방법입니다. 이 매개 변수는 LINETRANSFERMODE_ 상수 중 하나를 사용합니다.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCONSULTCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALTRANSFERMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

설명

lineCompleteTransfer 함수에 대한 호출에 대한 응답으로 전송된 LINE_REPLY 메시지는 hCall 매개 변수로 지정된 호출의 상태 기반으로 합니다.

이 작업은 hConsultCall에 의해 현재 연결된 파티로 원래 호출 hCall의 전송을 완료합니다. 상담 전화는 일반적으로 lineSetupTransfer의 일부로 할당된 상담 통화에 전화를 걸지만 스위치가 hCall을 전송할 수 있는 모든 호출일 수 있습니다.

전송 요청은 전송 또는 3방향 전화 회의로 확인할 수 있습니다. 전송으로 확인되면 hCall 및 hConsultCall 로 연결된 당사자가 서로 연결되고 hCall 및 hConsultCall 은 일반적으로 애플리케이션의 줄에서 지워지고 유휴 상태로 전환됩니다. 애플리케이션의 호출 핸들은 전송이 완료된 후에도 유효한 상태로 유지합니다. 애플리케이션이 전송된 호출에 더 이상 관심이 없는 경우 lineDeallocateCall 을 사용하여 핸들의 할당을 취소해야 합니다.

회의로 해결되면 세 당사자는 모두 컨퍼런스 콜에 참가합니다. 기존 호출 핸들은 모두 유효하지만 회의 된 상태로 전환됩니다. 전화 회의 핸들이 만들어지고 반환되고 연결된 상태로 전환됩니다.

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

lineBlindTransfer를 사용하여 호출의 블라인드 전송을 수행할 수도 있습니다.