TSPI_lineAnswer 함수(tspi.h)

아티클
08/26/2023

TSPI_lineAnswer 함수는 지정된 제품 호출에 응답합니다.

구문

LONG TSPIAPI TSPI_lineAnswer(
  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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INUSE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG.

설명

새 호출이 도착하면 서비스 공급자는 TAPI에 LINE_NEWCALL 메시지를 전송하여 호출에 대한 핸들을 교환합니다. 서비스 공급자는 LINE_CALLSTATE 메시지와 함께 이를 따라 TAPI 및 해당 클라이언트 애플리케이션에 호출 상태를 알릴 수 있습니다. 클라이언트 애플리케이션은 일반적으로 TSPI_lineAnswer 사용하여 호출에 응답합니다. 일반적으로 호출이 성공적으로 응답되면 호출이 연결된 상태로 전환됩니다.

사용자 경고가 통화 제공과 별개인 일부 전화 통신 환경(예: ISDN)에서는 TAPI 및 해당 클라이언트 애플리케이션이 먼저 응답하기 전에 전화를 수락하거나 제품 통화를 거부하거나 리디렉션하는 옵션을 사용할 수 있습니다.

다른 호출이 이미 활성 상태일 때 호출이 제공되면 TSPI_lineAnswer 호출하여 새 호출이 연결됩니다. 기존 활성 호출에 미치는 영향은 라인의 디바이스 기능에 따라 달라집니다. 첫 번째 호출은 영향을 받지 않거나, 자동으로 삭제되거나, 자동으로 보류될 수 있습니다. 적절한 LINE_CALLSTATE 메시지는 두 호출에 대해 TAPI로의 상태 전환을 보고하는 데 사용됩니다.