lineReleaseUserUserInfo 함수(tapi.h)

아티클
08/26/2023

lineReleaseUserUserInfo 함수는 애플리케이션이 LINECALLINFO 구조에 포함된 사용자-사용자 정보를 처리했으며 이후에 받은 사용자-사용자 정보를 해당 구조체에 쓸 수 있음을 서비스 공급자에게 알릴 수 있습니다. 서비스 공급자는 새 정보를 사용할 수 있는 경우 LINECALLINFOSTATE_USERUSERINFO 나타내는 LINE_CALLINFO 메시지를 보냅니다.

구문

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

매개 변수

hCall

호출에 대한 핸들입니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태는 모든 상태일 수 있습니다.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

설명

lineReleaseUserUserInfo 함수를 사용하면 애플리케이션이 ISDN 연결에서 들어오는 사용자-사용자 정보의 흐름을 제어할 수 있습니다. 새로운 완전한 사용자 정보 메시지가 수신되면 서비스 공급자는 LINE_CALLINFO 메시지( LINECALLINFOSTATE_USERUSERINFO 지정)를 사용하여 애플리케이션에 알릴 수 있습니다. 임의의 수의 애플리케이션이 정보를 검사할 수 있지만( lineGetCallInfo 사용) 후속 정보를 보고할 수 있도록 정보가 릴리스될 때 호출 컨트롤을 소유하는 애플리케이션입니다. 서비스 공급자는 lineReleaseUserUserInfo가 호출될 때까지 LINECALLINFO의 이전 사용자 정보를 최신 정보로 덮어쓰지 않습니다. 호출을 소유한 애플리케이션에서 이전 정보를 공개할 때까지 이후에 수신된 사용자-사용자 정보를 버퍼링하는 것은 서비스 공급자의 책임입니다.