lineSendUserUserInfo 함수(tapi.h)

아티클
03/08/2023

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

구문

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

매개 변수

hCall

사용자-사용자 정보를 보낼 호출을 처리합니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태는 연결, 제공, 수락 또는 링백이어야 합니다.

lpsUserUserInfo

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

dwSize

lpsUserUserInfo의 사용자-사용자 정보 크기(바이트)입니다.

반환 값

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

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

설명

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

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

이 함수는 암호화되지 않은 형식으로 와이어를 통해 데이터를 보낼 수 있습니다. 따라서 네트워크에서 도청하는 사용자가 데이터를 읽을 수 있습니다. 이 메서드를 사용하기 전에 데이터를 명확한 텍스트로 보내는 보안 위험을 고려해야 합니다.