TSPI_lineRedirect 함수(tspi.h)

아티클
08/26/2023

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

구문

LONG TSPIAPI TSPI_lineRedirect(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

매개 변수

dwRequestID

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

hdCall

리디렉션할 호출에 대한 핸들입니다. hdCall의 호출 상태가 제공될 수 있습니다.

lpszDestAddress

대상 주소를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 표준 링크 형식을 따릅니다.

dwCountryCode

통화가 리디렉션되는 파티의 국가 또는 지역 코드입니다. 값을 0으로 지정하면 구현에서 기본값이 사용됩니다. 이 함수가 호출될 때 TAPI에서 이 매개 변수의 유효성을 검사하지 않습니다.

반환 값

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

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

설명

서비스 공급자는 LINEERR_INVALADDRESS 반환하는 경우 호출을 리디렉션하지 않습니다.

이 함수가 호출되면 서비스 공급자는 먼저 호출에 응답하지 않고 다른 주소로 제공 호출을 편향합니다. 호출 리디렉션은 호출된 스테이션의 개입 없이 스위치에서 수행되는 착신 전환과 다릅니다. 리디렉션은 클라이언트 애플리케이션(예: 호출자 ID 정보 기반)에서 호출 기준으로 수행할 수 있습니다. 통화를 전송하려면 먼저 통화를 응답해야 한다는 점에서 통화 전송과 다릅니다.

호출이 성공적으로 리디렉션되면 호출은 일반적으로 유휴 상태로 전환됩니다. 서비스 공급자는 LINE_CALLSTATE 메시지를 사용하여 새 상태를 나타냅니다.