TSPI_lineSendUserUserInfo 함수(tspi.h)

아티클
08/26/2023

TSPI_lineSendUserUserInfo 함수는 지정된 호출에서 원격 당사자에게 사용자-사용자 정보를 보냅니다.

구문

LONG TSPIAPI TSPI_lineSendUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

매개 변수

dwRequestID

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

hdCall

사용자-사용자 정보를 보낼 호출에 대한 핸들입니다. hdCall의 호출 상태는 연결, 제공, 수락 또는 링백일 수 있습니다.

lpsUserUserInfo

원격 당사자에게 보낼 사용자-사용자 정보를 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 사용자-사용자 정보는 기본 네트워크에서 지원하는 경우에만 전송 됩니다(LINEDEVCAPS 참조).

dwSize

lpsUserUserInfo의 사용자-사용자 정보의 null 종결자를 포함한 크기(바이트)입니다.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

설명

이 함수는 연결된 호출 중에 언제든지 사용자-사용자 정보를 보내는 데 사용할 수 있습니다. 전송할 지정된 정보의 크기가 ISDN에서와 같이 단일 네트워크 메시지에 들어갈 수 있는 것보다 큰 경우 서비스 공급자는 정보를 연결된 네트워크 메시지 시퀀스("더 많은 데이터"를 사용)로 나누는 역할을 담당합니다.

사용자-사용자 정보는 통화 수락, 통화 거부, 통화 리디렉션 및 호출할 때의 일부로 전송될 수도 있습니다. 사용자-사용자 정보도 받을 수 있습니다. 수신된 정보는 호출의 LINECALLINFO 구조에 보고됩니다. 호출 제공 후 또는 통화 연결 끊기 전에 사용자-사용자 정보가 도착할 때마다 UserUserInfo 매개 변수가 있는 LINE_CALLINFO 메시지는 TAPI에 호출 정보 레코드의 사용자-사용자 정보가 변경되었음을 알 수 있습니다. 여러 네트워크 메시지가 연결된 경우 정보는 서비스 공급자에 의해 어셈블되고 단일 메시지가 TAPI로 전송됩니다.