TSPI_lineHold 함수(tspi.h)

아티클
08/26/2023

TSPI_lineHold 함수는 지정된 호출을 보류합니다.

구문

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

매개 변수

dwRequestID

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

hdCall

보류할 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태를 연결할 수 있습니다.

반환 값

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

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

설명

보류 중인 통화의 연결이 일시적으로 끊어지면 TAPI가 다른 통화를 하거나 응답하기 위해 회선 디바이스를 사용할 수 있습니다. TSPI_lineHold상담 전화와는 달리 지정된 통화를 열심히 보류합니다. 하드 홀드에 전화는 일반적으로 전송하거나 전화 회의에 포함 할 수 없습니다, 상담 전화는 할 수있는 반면. 상담 전화는 TSPI_lineSetupTransfer, TSPI_lineSetupConference 또는 TSPI_linePrepareAddToConference 사용하여 시작됩니다.

호출이 보류된 후 호출 상태는 일반적으로 onHold로 전환됩니다. 보류된 통화는 TSPI_lineUnhold 통해 검색됩니다. 통화가 보류 중인 동안 서비스 공급자는 보류된 호출의 상태 변경에 대한 LINE_CALLSTATE 메시지를 보낼 수 있습니다. 예를 들어 보류된 파티가 중단되면 호출 상태가 연결 끊김으로 전환될 수 있으며 서비스 공급자는 새 상태를 나타내는 LINE_CALLSTATE 메시지를 보낼 수 있습니다.