lineSetAppSpecific 함수(tapi.h)

아티클
03/13/2024

lineSetAppSpecific 함수를 사용하면 애플리케이션이 지정된 호출의 호출 정보 레코드의 애플리케이션별 필드를 설정할 수 있습니다.

구문

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

매개 변수

hCall

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

dwAppSpecific

호출의 LINECALLINFO 구조체에 대한 dwAppSpecific 멤버의 새 콘텐츠입니다. 이 값은 전화 통신 API에서 해석되지 않습니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

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

설명

각 호출에 대해 존재하는 LINECALLINFO 데이터 구조의 애플리케이션별 필드는 전화 통신 API 또는 해당 서비스 공급자에 의해 해석되지 않습니다. 해당 사용법은 애플리케이션에 의해 완전히 정의됩니다. lineGetCallInfo에서 반환된 LINECALLINFO 레코드에서 필드를 읽을 수 있습니다. 그러나 변경 내용이 다른 애플리케이션에 표시되도록 lineSetAppSpecific 을 사용하여 필드를 설정해야 합니다. 이 필드가 변경되면 호출 핸들이 있는 다른 모든 애플리케이션은 dwAppSpecific 멤버가 변경되었음을 나타내는 LINE_CALLINFO 메시지를 보냅니다.