lineSetStatusMessages 함수(tapi.h)

아티클
08/26/2023

lineSetStatusMessages 함수를 사용하면 애플리케이션이 지정된 줄 또는 해당 주소에 대한 상태 변경 내용과 관련된 이벤트에 대해 수신할 알림 메시지를 지정할 수 있습니다.

구문

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

매개 변수

hLine

줄 디바이스에 대한 핸들입니다.

dwLineStates

애플리케이션에 메시지를 보낼 줄 디바이스 상태 변경 내용을 식별하는 비트 배열입니다. 이 매개 변수는 하나 이상의 LINEDEVSTATE_ 상수를 사용합니다.

dwAddressStates

메시지를 애플리케이션으로 보낼 주소 상태 변경 내용을 식별하는 비트 배열입니다. 이 매개 변수는 하나 이상의 LINEADDRESSSTATE_ 상수를 사용합니다.

반환 값

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

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

설명

TAPI는 줄 및 주소에서 발생하는 이벤트에 대해 애플리케이션에 알리는 여러 메시지를 정의합니다. 애플리케이션은 모든 주소 및 줄 상태 변경 메시지를 받는 데 관심이 없을 수 있습니다. lineSetStatusMessages 함수를 사용하여 애플리케이션이 수신하는 메시지를 선택할 수 있습니다. 기본적으로 주소 및 줄 상태 보고는 사용하지 않도록 설정됩니다.