lineHold 함수(tapi.h)

아티클
08/26/2023

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

구문

LONG lineHold(
  HCALL hCall
);

매개 변수

hCall

보류할 호출에 대한 핸들입니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태를 연결해야 합니다.

반환 값

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

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

설명

보류 중인 통화의 연결이 일시적으로 끊어지므로 애플리케이션이 다른 전화를 걸거나 응답하기 위해 회선 디바이스를 사용할 수 있습니다. lineHold 함수는 지정된 호출의 소위 "하드 홀드"를 수행합니다("상담 전화"와 반대). 하드 홀드에 전화는 일반적으로 전송하거나 전화 회의에 포함 할 수 없습니다, 하지만 상담 전화는 할 수 있습니다. 상담 호출은 lineSetupTransfer, lineSetupConference 또는 linePrepareAddToConference를 사용하여 시작됩니다.

호출이 성공적으로 보류된 후 호출 상태는 일반적으로 onHold로 전환됩니다. 보류된 호출은 lineUnhold에 의해 검색됩니다. 통화가 보류되는 동안 애플리케이션은 보류된 호출의 상태 변경에 대한 LINE_CALLSTATE 메시지를 받을 수 있습니다. 예를 들어 보류된 파티가 중단되면 호출 상태가 연결 끊김으로 전환될 수 있습니다.

브리지된 상황에서는 호출에 있는 다른 스테이션의 상태 제어할 수 있기 때문에(예: 다른 스테이션이 참여할 수 없을 때 통화를 "보류"하려는 경우) lineHold 작업이 실제로 통화를 보류하지 않을 수 있습니다. 대신 다른 스테이션에서 연결된 상태로 유지되는 경우 호출을 LINECONNECTEDMODE_INACTIVE 모드로 변경할 수 있습니다.