TSPI_lineReleaseUserUserInfo 함수(tspi.h)

아티클
03/03/2024

TSPI_lineReleaseUserUserInfo 함수는 LINECALLINFO 구조에 포함된 사용자-사용자 정보가 처리되었으며 이후에 받은 사용자-사용자 정보를 해당 구조에 기록할 수 있음을 서비스 공급자에게 알릴 수 있습니다. 서비스 공급자는 새 정보를 사용할 수 있는 경우 LINECALLINFOSTATE_USERUSERINFO 나타내는 LINE_CALLINFO 메시지를 보냅니다.

구문

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

매개 변수

dwRequestID

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

hdCall

사용자-사용자 정보를 해제할 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 임의의 상태일 수 있습니다.

반환 값

dwRequestID를 반환하거나 오류가 발생하는 경우 오류 번호를 반환합니다. 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 함수가 성공하면 0이거나 오류가 발생하면 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

설명

TSPI_lineReleaseUserUserInfo 함수를 사용하면 ISDN 연결에서 들어오는 사용자-사용자 정보의 흐름을 제어할 수 있습니다. 새로운 전체 사용자 정보 메시지가 수신되면 서비스 공급자는 LINE_CALLINFO 메시지( LINECALLINFOSTATE_USERUSERINFO 지정)를 사용하여 TAPI에 알릴 수 있습니다. LINECALLINFO의 사용자-사용자 정보 및 기타 필드는 TSPI_lineGetCallInfo 대한 여러 호출을 통해 검사할 수 있습니다. 서비스 공급자는 TSPI_lineReleaseUserUserInfo 호출될 때까지 LINECALLINFO의 이전 사용자 정보를 최신 정보로 덮어써서는 안됩니다. 서비스 공급자는 이전 정보가 릴리스될 때까지 이후에 받은 사용자-사용자 정보를 버퍼링해야 합니다. 버퍼링된 나머지 정보는 TSPI_lineCloseCall 호출될 때 삭제할 수 있습니다.

LINECALLINFO에 사용자-사용자 정보가 없는 동안 이 함수가 호출되는 경우 서비스 공급자는 성공의 표시를 반환해야 합니다.

이전 버전과의 호환성을 위해 TAPI는 함수를 내보내지 않는 서비스 공급자의 제어 하에 있는 줄에 대한 호출에 대해 이 함수가 호출되면 LINEERR_OPERATIONUNAVAIL 자동으로 반환합니다.