TSPI_lineAccept 함수(tspi.h)

아티클
08/26/2023

TSPI_lineAccept 함수는 지정된 제공된 호출을 수락합니다. 필요에 따라 지정된 사용자-사용자 정보를 통화 당사자에게 보낼 수 있습니다.

구문

LONG TSPIAPI TSPI_lineAccept(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

매개 변수

dwRequestID

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

hdCall

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

lpsUserUserInfo

통화 수락의 일부로 원격 당사자에게 보낼 사용자-사용자 정보를 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 이 포인터는 전송할 사용자-사용자 정보가 없는 경우 NULL 입니다. 사용자-사용자 정보는 기본 네트워크에서 지원하는 경우에만 전송 됩니다(LINEDEVCAPS 참조).

dwSize

lpsUserUserInfo의 사용자-사용자 정보의 크기(바이트)입니다. lpsUserUserInfo가 NULL이면 dwSize는 무시됩니다.

반환 값

함수가 비동기적으로 완료되면 dwRequestID 를 반환하고 오류가 발생하면 오류 번호를 반환합니다. 해당 ASYNC_COMPLETIONlResult 매개 변수는 함수가 성공하면 0이거나 오류가 발생하면 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

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

설명

TSPI_lineAccept 함수는 수신 호출과 연결된 경고를 호출의 초기 제공과 분리할 수 있도록 하는 전화 통신 환경(예: ISDN)에서 사용됩니다. 통화가 들어오면 통화가 처음 제공됩니다. 약간의 시간 동안 클라이언트 애플리케이션에는 TSPI_lineDrop 사용하여 통화를 거부하거나, TSPI_lineRedirect 사용하여 다른 스테이션으로 통화를 리디렉션하거나, TSPI_lineAnswer 사용하여 통화에 응답하거나, TSPI_lineAccept 사용하여 통화를 수락하는 옵션이 있을 수 있습니다. 호출이 성공적으로 수락되면 호출된 디바이스와 호출 디바이스 모두에서 경고가 시작되고 일반적으로 호출 상태가 수락 됨 상태로 전환됩니다. 애플리케이션이 경고를 시작하기 위해 TSPI_lineAccept 호출해야 하는 경우 서비스 공급자는 LINEADDRESSCAPS 데이터 구조의 dwAddrCapFlags 멤버에 플래그 LINEADDRCAPFLAGS_ACCEPTTOALERT 설정해야 합니다.

TAPI에 대해 경고는 벨소리 표시와 함께 LINE_LINEDEVSTATE 메시지를 사용하여 보고됩니다.

TSPI_lineAccept ISDN이 아닌 서비스 공급자에서도 지원될 수 있습니다. 수락된 상태로의 호출 상태 전환은 일부 애플리케이션이 호출에 대한 책임을 주장하고 사용자에게 호출을 표시했음을 나타내는 다른 TAPI 클라이언트에서 사용할 수 있습니다.

클라이언트 애플리케이션에는 수락 시 사용자-사용자 정보를 보낼 수 있는 옵션이 있습니다. 사용자-사용자 정보를 보낼 수 있더라도 네트워크에서 이 정보를 통화 당사자에게 전달한다는 보장은 없는 경우가 많습니다. 클라이언트 애플리케이션은 회선의 디바이스 기능을 참조하여 통화 수락을 사용할 수 있는지 여부를 확인할 수 있습니다.