TSPI_lineCompleteTransfer 함수(tspi.h)

아티클
08/26/2023

TSPI_lineCompleteTransfer 함수는 상담 통화에 연결된 당사자에게 지정된 통화의 전송을 완료합니다. dwTransferMode가 LINETRANSFERMODE_CONFERENCE 경우 원래 호출 핸들이 전화 회의로 변경됩니다. 그렇지 않으면 서비스 공급자가 호출을 유휴 상태로 변경하는 호출 상태 메시지를 보내야 합니다.

구문

LONG TSPIAPI TSPI_lineCompleteTransfer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  HDRVCALL      hdConsultCall,
  HTAPICALL     htConfCall,
  LPHDRVCALL    lphdConfCall,
  DWORD         dwTransferMode
);

매개 변수

dwRequestID

비동기 요청의 식별자입니다.

hdCall

전송할 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 onHoldPendingTransfer일 수 있습니다.

hdConsultCall

전송 대상에 대한 연결을 나타내는 호출에 대한 핸들입니다. hdConsultCall의 호출 상태는 연결, 링백, 사용 중 또는 진행 중일 수 있습니다.

htConfCall

이 매개 변수는 dwTransferMode 가 LINETRANSFERMODE_CONFERENCE 지정된 경우에만 유효합니다. 서비스 공급자는 이 매개 변수 값을 저장하고 호출 시 이벤트를 보고하는 LINEEVENT 프로시저에 대한 모든 후속 호출에서 사용해야 합니다. 그렇지 않으면 이 매개 변수가 무시됩니다.

lphdConfCall

호출에 대한 서비스 공급자의 식별자를 나타내는 HDRVCALL 에 대한 포인터입니다. 이 매개 변수는 dwTransferMode 가 LINETRANSFERMODE_CONFERENCE 지정된 경우에만 유효합니다. 서비스 공급자는 이 함수에서 반환하기 전에 새 전화 회의에 대한 핸들로 이 위치를 채워야 합니다.

dwTransferMode

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

반환 값

오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 함수가 성공하면 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 0이거나 오류가 발생할 경우 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

설명

이 함수는 원래 호출 인 hdCall을 hdConsultCall을 통해 현재 연결된 파티로 전송을 완료합니다. 상담 전화는 일반적으로 TSPI_lineSetupTransfer 일부로 할당된 상담 통화로 전화를 걸지만 스위치가 hdCall을 전송할 수 있는 모든 호출일 수 있습니다.

이전 요청은 이전 또는 3방향 전화 회의로 확인할 수 있습니다. 전송으로 확인되면 hdCall 및 hdConsultCall을 통해 연결된 당사자가 서로 연결되고 hdCall 및 hdConsultCall이 모두 유휴 상태로 전환됩니다.

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

TSPI_lineBlindTransfer 사용하여 통화의 블라인드 전송을 수행할 수도 있습니다.

이 함수는 호출 수명을 시작하기 위해 TSPI 모델을 따른다는 점에서 해당 TAPI 함수와 다릅니다. TAPI와 서비스 공급자는 서로 호출을 나타내는 불투명 핸들을 교환합니다. 또한 서비스 공급자는 이 절차에서 반환되기 전에 새 호출에 대한 콜백을 수행할 수 있습니다. 어떤 경우든 서비스 공급자는 일치하는 ASYNC_COMPLETION 메시지가 성공을 보고할 때까지 반환된 핸들을 "아직 유효하지 않음"으로 처리해야 합니다. 즉, 새 호출에 대한 LINEEVENT 메시지를 실행하거나 메시지의 호출 수 또는 줄에 대한 상태 데이터 구조에 포함해서는 안 됩니다.