lineRedirect 함수(tapi.h)

아티클
03/02/2024

lineRedirect 함수는 지정된 제품 호출을 지정된 대상 주소로 리디렉션합니다.

구문

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

매개 변수

hCall

리디렉션할 호출에 대한 핸들입니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태는 제공해야 합니다.

lpszDestAddress

대상 주소에 대한 포인터입니다. 표준 전화 걸기 가능 번호 형식을 따릅니다.

dwCountryCode

호출이 리디렉션되는 파티의 국가/지역 코드입니다. 값을 0으로 지정하면 구현에서 기본값이 사용됩니다.

반환 값

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

LINEERR_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

설명

호출 리디렉션을 사용하면 애플리케이션이 먼저 통화에 응답하지 않고도 다른 주소로의 제공 호출을 편향할 수 있습니다. 호출 리디렉션은 애플리케이션의 개입 없이 스위치에 의해 수행되는 호출 전달의 콜 착신 전환과 다릅니다. 리디렉션은 호출자 ID 정보에 의해 구동되는 애플리케이션에서 호출 기준으로 수행할 수 있습니다. 통화를 전송하려면 먼저 통화를 응답해야 한다는 점에서 통화 전송과 다릅니다.

호출이 성공적으로 리디렉션된 후 호출은 일반적으로 유휴 상태로 전환됩니다.

들어오는 호출을 리디렉션하는 것 외에도 애플리케이션에는 lineAccept를 사용하여 호출을 수락하거나, lineDrop을 사용하여 통화를 거부하거나, lineAnswer를 사용하여 호출에 응답하는 옵션이 있을 수 있습니다. 이러한 작업의 가용성은 디바이스 기능에 따라 달라집니다.