lineAccept 함수(tapi.h)

아티클
08/26/2023

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

구문

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

매개 변수

hCall

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

lpsUserUserInfo

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

dwSize

lpsUserUserInfo(null 종결자 포함)의 사용자-사용자 정보 크기(바이트)입니다. lpsUserUserInfo가 NULL이면 호출 당사자에게 사용자-사용자 정보가 전송되지 않고 dwSize가 무시됩니다.

반환 값

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

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

설명

lineAccept 함수는 들어오는 호출과 관련된 경고를 호출의 초기 제공과 분리할 수 있도록 하는 ISDN(통합 서비스 디지털 네트워크)과 같은 전화 통신 환경에서 사용됩니다. 전화가 오면 먼저 제공됩니다. 약간의 시간 동안 애플리케이션은 lineDrop을 사용하여 통화를 거부하거나, lineRedirect를 사용하여 다른 스테이션으로 통화를 리디렉션하거나, lineAnswer를 사용하여 통화에 응답하거나, lineAccept를 사용하여 통화를 수락하는 옵션이 있을 수 있습니다. 애플리케이션에서 호출을 성공적으로 수락한 후 호출된 디바이스와 호출 디바이스 모두에서 경고가 시작되고 호출 상태가 일반적으로 수락됨으로 전환됩니다.

경고는 벨소리 표시와 함께 LINE_LINEDEVSTATE 메시지에 의해 애플리케이션에 보고됩니다.

lineAccept 함수는 비 ISDN 서비스 공급자에서도 지원될 수 있습니다. 수락됨으로의 호출 상태 전환은 다른 애플리케이션이 호출에 대한 책임을 주장하고 사용자에게 호출을 표시했음을 나타내는 표시로 사용할 수 있습니다.

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