lineAnswer 함수(tapi.h)

아티클
08/26/2023

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

구문

LONG lineAnswer(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

매개 변수

hCall

응답할 호출에 대한 핸들입니다. 애플리케이션은 이 호출의 소유자여야 합니다. hCall의 호출 상태는 제공되거나 수락되어야 합니다.

lpsUserUserInfo

통화가 응답될 때 원격 당사자에게 보낼 사용자-사용자 정보를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 사용자-사용자 정보를 보낼 수 없는 경우 이 포인터는 NULL 로 남을 수 있습니다. 사용자-사용자 정보는 기본 네트워크에서 지원하는 경우에만 전송됩니다( LINEDEVCAPS 참조). 필요한 경우 사용자-사용자 정보에 대한 프로토콜 판별자 필드는 lpsUserUserInfo가 가리키는 버퍼의 첫 번째 바이트로 표시되어야 하며 dwSize에서 를 고려해야 합니다.

dwSize

lpsUserUserInfo(null 종결자 포함)의 사용자-사용자 정보 크기(null 종결자 포함)(lpsUserUserInfo가 NULL인 경우 사용자-사용자 정보는 호출 당사자에게 전송되지 않으며 dwSize는 무시됩니다.

반환 값

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

LINEERR_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER.

설명

새 호출이 도착하면 호출에 관심이 있는 애플리케이션은 LINE_CALLSTATE 메시지를 전송하여 새 호출 핸들을 제공하고 호출 상태 및 새 호출에 대한 권한(예: 모니터 또는 소유자)에 대해 애플리케이션에 알릴 수 있습니다. 호출에 대한 소유자 권한이 있는 애플리케이션은 lineAnswer를 사용하여 이 호출에 응답할 수 있습니다. 호출이 성공적으로 응답되면 호출은 일반적으로 연결된 상태로 전환됩니다. 처음에는 하나의 애플리케이션만 들어오는 호출에 대한 소유자 권한이 부여됩니다.

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

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

브리지된 상황에서 호출이 연결되었지만 LINECONNECTEDMODE_INACTIVE 상태인 경우 lineAnswer 함수를 사용하여 조인할 수 있습니다.

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